SoundInitDataItem

VOID
    SoundInitDataItem(
        PMIXER_INFO
MixerInfo,
        PMIXER_DATA_ITEM
MixerDataItem,
        USHORT
Message,
        USHORT
Id
        );

The SoundInitDataItem function adds a mixer data item to an internal list. Mixer data items represent mixer lines and controls. When items on the list change state, clients are notified of the change.

Parameters
MixerInfo
Pointer to a MIXER_INFO structure.
MixerDataItem
Pointer to an empty, globally-allocated MIXER_DATA_ITEM structure.
Message
Message to be sent to the client when an item changes. One of the following messages will be sent:
  • MM_MIXM_LINE_CHANGE, for mixer line items.

  • MM_MIXM_CONTROL_CHANGE, for mixer control items.
Id
Driver-defined ID value.
Return Value

None.

Comments

The pointer specified by MixerDataItem is added to the ChangedItems list for the specified MIXER_INFO structure. The driver calls SoundMixerChangedItem when an item on the ChangedItems list changes state.

Drivers calling SoundInitDataItem must include mixer.h.