KSPROPERTY_AUDIO_CHANNEL_CONFIG
Die KSPROPERTY_AUDIO_CHANNEL_CONFIG-Eigenschaft gibt die tatsächliche räumliche Platzierung von Kanälen im Audiostream an, den ein Knoten ausgibt.
Nutzungszusammenfassungstabelle
Herunterladen | Set | Ziel | Eigenschaftsdeskriptortyp | Eigenschaftswerttyp |
---|---|---|---|---|
Ja |
Ja |
Filtern/Anheften |
KSNODEPROPERTY |
Der Eigenschaftswert (Vorgangsdaten) ist eine Struktur vom Typ KSAUDIO_CHANNEL_CONFIG. Diese Struktur gibt die Kanäle an, die im Ausgabestream enthalten sind, und die Zuweisung dieser Kanäle zu Lautsprechern.
Rückgabewert
Eine KSPROPERTY_AUDIO_CHANNEL_CONFIG-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
Bei Verwendung als Eigenschaft eines DAC-Knotens (KSNODETYPE_DAC) oder eines 3D-Knotens (KSNODETYPE_3D_EFFECTS) gibt die KSPROPERTY_AUDIO_CHANNEL_CONFIG-Eigenschaft die DirectSound-Lautsprecherkonfiguration an. Für Stereolautsprecherkonfigurationen wird diese Eigenschaft in Verbindung mit der KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY-Eigenschaft verwendet, die zwischen Kopfhörern und mehreren Stereolautsprecherkonfigurationen unterscheidet. Weitere Informationen zu Lautsprecherkonfigurationen finden Sie unter DirectSound Speaker-Configuration Einstellungen.
DirectSound verwendet auch die KSPROPERTY_AUDIO_CHANNEL_CONFIG-Eigenschaft, um einen Knoten "schwenken" für seine Kanalkonfiguration abzufragen. Ein Schwenkknoten ist der zweite Volumeknoten (KSNODETYPE_VOLUME) auf einem Mixerstift, der die Anforderungen für die Bestellung von DirectSound-Knoten erfüllt. Die DirectSound-Implementierung der IDirectSoundBuffer::SetPan-Methode (in der Microsoft Windows SDK-Dokumentation beschrieben) verwendet die KSPROPERTY_AUDIO_VOLUMELEVEL-Eigenschaft des pan-Knotens, um das Verschieben zu steuern.
DirectSound behandelt KSPROPERTY_AUDIO_CHANNEL_CONFIG als Filtereigenschaft auf einem DAC-Knoten und als Pineigenschaft auf Volume- und 3D-Knoten.
Clients verwenden diese Eigenschaft auch, um das Format des Datenstroms auszuwählen, den ein KSNODETYPE_PROLOGIC_DECODER Knoten ausgibt.
Anforderungen
Header |
Ksmedia.h (include Ksmedia.h) |