KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY

Artikel
06/14/2023

Die KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY-Eigenschaft wird in Kombination mit KSPROPERTY_AUDIO_CHANNEL_CONFIG verwendet, um die DirectSound-Lautsprecherkonfigurationseigenschaft für hardwarebeschleunigte 3D-Audiowiedergabe zu implementieren. Dies ist eine optionale Eigenschaft von DAC-Knoten (KSNODETYPE_DAC) und 3D-Knoten (KSNODETYPE_3D_EFFECTS).

Nutzungszusammenfassungstabelle

Herunterladen	Set	Ziel	Eigenschaftsdeskriptortyp	Eigenschaftswerttyp
Ja	Ja	Anheften/Filtern	KSNODEPROPERTY	LONG

Der Eigenschaftswert (Vorgangsdaten) ist vom Typ LONG und gibt die Lautsprechergeometrie an. Dieser Wert kann auf eine der folgenden Konstanten festgelegt werden, die in der Headerdatei Ksmedia.h definiert sind:

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

Die obigen Parameter entsprechen in der Bedeutung (aber nicht gleich im Wert) den folgenden Werten, die von der IDirectSound::GetSpeakerConfig-Methode verwendet werden (siehe Microsoft Windows SDK Dokumentation) und werden in der Headerdatei Dsound.h definiert:

DSSPEAKER_HEADPHONE
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_MIN
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_NARROW
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_WIDE
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_MAX

Rückgabewert

Eine KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY-Eigenschaftsanforderung gibt STATUS_SUCCESS zurück, um anzugeben, dass sie erfolgreich abgeschlossen wurde. Andernfalls gibt die Anforderung einen entsprechenden Fehler status Code zurück.