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.