Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |