KSPROPERTY_AUDIO_CHANNEL_CONFIG

Artikel
06/15/2023

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	KSAUDIO_CHANNEL_CONFIG

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.