title | description | keywords | topic_type | ms.topic | api_name | api_location | api_type | ms.date | |||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
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. |
|
|
reference |
|
|
|
03/06/2023 |
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).
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
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.
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.
Header |
Ksmedia.h (include Ksmedia.h) |