KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY
The KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY property is used in combination with KSPROPERTY_AUDIO_CHANNEL_CONFIG to implement the DirectSound speaker-configuration property for hardware-accelerated 3D audio. This is an optional property of DAC nodes (KSNODETYPE_DAC) and 3D nodes (KSNODETYPE_3D_EFFECTS).
Usage Summary Table
Get | Set | Target | Property descriptor type | Property value type |
---|---|---|---|---|
Yes |
Yes |
Pin/Filter |
LONG |
The property value (operation data) is of type LONG and specifies the speaker geometry. This value can be set to one of the following constants, which are defined in header file Ksmedia.h:
KSAUDIO_STEREO_SPEAKER_GEOMETRY_HEADPHONES
KSAUDIO_STEREO_SPEAKER_GEOMETRY_MIN
KSAUDIO_STEREO_SPEAKER_GEOMETRY_NARROW
KSAUDIO_STEREO_SPEAKER_GEOMETRY_WIDE
KSAUDIO_STEREO_SPEAKER_GEOMETRY_MAX
The preceding parameters are equivalent in meaning (but not equal in value) to the following values, which are used by the IDirectSound::GetSpeakerConfig method (see the Microsoft Windows SDK documentation) and are defined in header file Dsound.h:
DSSPEAKER_HEADPHONE
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_MIN
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_NARROW
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_WIDE
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_MAX
Return Value
A KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY property request returns STATUS_SUCCESS to indicate that it has completed successfully. Otherwise, the request returns an appropriate error status code.
Remarks
DirectSound treats KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY as a filter property on a DAC node, and as a pin property on a 3D node.
For additional information, see DirectSound Speaker-Configuration Settings.
Requirements
Header |
Ksmedia.h (include Ksmedia.h) |