Freigeben über


IAudioChannelConfig-Schnittstelle (devicetopology.h)

Die IAudioChannelConfig-Schnittstelle ermöglicht den Zugriff auf ein Hardwarekanalkonfigurationssteuerelement. Der Client ruft einen Verweis auf die IAudioChannelConfig-Schnittstelle einer Untereinheit ab, indem die IPart::Activate-Methode aufgerufen wird, wobei der Parameter refiid auf REFIID IID_IAudioChannelConfig festgelegt ist. Der Aufruf von IPart::Activate ist nur erfolgreich, wenn die Untereinheit die IAudioChannelConfig-Schnittstelle unterstützt. Nur ein Untereinheitsobjekt, das ein Hardwarekanalkonfigurationssteuerelement darstellt, unterstützt diese Schnittstelle.

Ein Client der IAudioChannelConfig-Schnittstelle programmiert ein Hardwarekanalkonfigurationssteuerelement, indem er eine Kanalkonfigurationsmaske in das Steuerelement schreibt. Die Maske gibt die Zuweisung von Audiokanälen zu Lautsprechern an. Weitere Informationen zu Kanalkonfigurationsmasken finden Sie unter KSPROPERTY_AUDIO_CHANNEL_CONFIG.

Die meisten Windows-Audioadaptertreiber unterstützen das Windows-Treibermodell (WDM) und verwenden Kernelstreamingeigenschaften (KS), um die Hardwaresteuerungsparameter in Untereinheiten (als KS-Knoten bezeichnet) darzustellen. Die IAudioChannelConfig-Schnittstelle bietet bequemen Zugriff auf die KSPROPERTY_AUDIO_CHANNEL_CONFIG-Eigenschaft einer Untereinheit, die den UNTERTYP-GUID-Wert KSNODETYPE_3D_EFFECTS, KSNODETYPE_DAC, KSNODETYPE_VOLUME oder KSNODETYPE_PROLOGIC_DECODER hat. Um die Untertyp-GUID einer Untereinheit abzurufen, rufen Sie die IPart::GetSubType-Methode auf. Weitere Informationen zu KS-Eigenschaften und KS-Knotentypen finden Sie in der Windows DDK-Dokumentation.

Vererbung

Die IAudioChannelConfig-Schnittstelle erbt von der IUnknown-Schnittstelle . IAudioChannelConfig verfügt auch über die folgenden Typen von Membern:

Methoden

Die IAudioChannelConfig-Schnittstelle verfügt über diese Methoden.

 
IAudioChannelConfig::GetChannelConfig

Die GetChannelConfig-Methode ruft die aktuelle Kanalkonfigurationsmaske aus einem Kanalkonfigurationssteuerelement ab.
IAudioChannelConfig::SetChannelConfig

Die SetChannelConfig-Methode legt die Kanalkonfigurationsmaske in einem Kanalkonfigurationssteuerelement fest.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile devicetopology.h

Weitere Informationen

Kern-Audioschnittstellen

DeviceTopology-API

IPart::Activate