The KSPROPERTY_AUDIO_CHANNEL_CONFIG property specifies the actual spatial placement of channels in the audio stream that a node outputs.
|Get||Set||Target||Property descriptor type||Property value type|
The property value (operation data) is a structure of type KSAUDIO_CHANNEL_CONFIG. This structure specifies the channels that are contained in the output stream and the assignment of those channels to speakers.
A KSPROPERTY_AUDIO_CHANNEL_CONFIG property request returns STATUS_SUCCESS to indicate that it has completed successfully. Otherwise, the request returns an appropriate error status code.
When used as a property of a DAC node (KSNODETYPE_DAC) or 3D node (KSNODETYPE_3D_EFFECTS), the KSPROPERTY_AUDIO_CHANNEL_CONFIG property specifies the DirectSound speaker configuration. For stereo speaker configurations, this property is used in conjunction with the KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY property, which distinguishes between headphones and several stereo speaker configurations. For more information about speaker configurations, see DirectSound Speaker-Configuration Settings.
DirectSound also uses the KSPROPERTY_AUDIO_CHANNEL_CONFIG property to query a "pan" node for its channel configuration. A pan node is the second volume node (KSNODETYPE_VOLUME) on a mixer pin that meets the DirectSound node-ordering requirements. DirectSound implementation of the IDirectSoundBuffer::SetPan method (described in the Microsoft Windows SDK documentation) uses the pan node's KSPROPERTY_AUDIO_VOLUMELEVEL property to control panning.
DirectSound treats KSPROPERTY_AUDIO_CHANNEL_CONFIG as a filter property on a DAC node, and as a pin property on volume and 3D nodes.
Clients also use this property to select the format of the stream that a KSNODETYPE_PROLOGIC_DECODER node outputs.