KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY
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 |
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.
Bemerkungen
DirectSound behandelt KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY als Filtereigenschaft auf einem DAC-Knoten und als Pineigenschaft auf einem 3D-Knoten.
Weitere Informationen finden Sie unter DirectSound Speaker-Configuration Einstellungen.
Anforderungen
Header |
Ksmedia.h (include Ksmedia.h) |