Audioendpunkteigenschaften

  • Artikel

Die Headerdatei Mmdeviceapi.h definiert mehrere Eigenschaften von Audioendpunktgeräten in Windows Vista und höher. Der Windows-Audiodienst legt die Werte dieser Eigenschaften fest. Clients können diese Eigenschaften lesen, sollten sie jedoch nicht festlegen. Eigenschaftswerte werden als PROPVARIANT-Strukturen gespeichert.

Die empfohlene Methode zum Lesen der Eigenschaften eines Audioeingabegeräts ist die Verwendung der APIs im Windows.Devices.Enumeration-Namespace . Diese APIs werden für Windows Store-Apps und Desktop-Apps unterstützt. Informationen zu vorhandenen Desktop-Apps, die Geräteeigenschaften mithilfe der IMMDevice-Schnittstelle lesen, finden Sie unter Geräteeigenschaften. IMMDevice wird für Windows Store-Apps nicht unterstützt.

Codebeispiele zum Zugreifen auf die Eigenschaften eines Audioendpunktgeräts finden Sie in den folgenden Themen:

Informationen zu PROPVARIANT finden Sie in der Windows SDK-Dokumentation.

Die folgenden Eigenschaften sind spezifisch für Audioendpunktgeräte.

Eigenschaft BESCHREIBUNG
PKEY_AudioEndpoint_Association Ordnet eine Kernelstreaming-Pinkategorie (KS) einem Audioendpunktgerät zu.
PKEY_AudioEndpoint_ControlPanelPageProvider Gibt die CLSID des registrierten Anbieters der Geräteeigenschaftenerweiterung für das Audioendpunktgerät an.
PKEY_AudioEndpoint_Disable_SysFx Gibt an, ob Systemeffekte im freigegebenen Modus aktiviert sind, der zum oder vom Audioendpunktgerät fließt.
PKEY_AudioEndpoint_FormFactor Gibt die physischen Attribute des Audioendpunktgeräts an.
PKEY_AudioEndpoint_FullRangeSpeakers Gibt die Kanalkonfigurationsmaske für die Vollbereichslautsprecher an, die mit dem Audioendpunktgerät verbunden sind.
PKEY_AudioEndpoint_GUID Stellt den DirectSound-Gerätebezeichner bereit, der dem Audioendpunktgerät entspricht.
PKEY_AudioEndpoint_PhysicalSpeakers Definiert die Konfiguration des physischen Lautsprechers für das Audioendpunktgerät.
PKEY_AudioEngine_DeviceFormat Gibt das Geräteformat an. Dabei handelt es sich um das Format, das die Audio-Engine für den Datenstrom im freigegebenen Modus verwendet, der zum oder vom Audioendpunktgerät fließt.
PKEY_AudioEngine_OEMFormat Gibt das Standardformat des Geräts an, das zum Rendern oder Erfassen eines Datenstroms verwendet wird. Die Werte werden vom OEM in einer INF-Datei aufgefüllt.
PKEY_AudioEndpoint_Supports_EventDriven_Mode Gibt an, ob der Endpunkt den ereignisgesteuerten Modus unterstützt. Die Werte werden vom OEM in einer INF-Datei aufgefüllt.
PKEY_AudioEndpoint_JackSubType Enthält eine Ausgabekategorie-GUID für ein Audioendpunktgerät.

Die Kernaudio-APIs unterstützen zusätzliche Eigenschaften, die nicht ausschließlich für Audioendpunktgeräte gelten. Weitere Informationen zu diesen zusätzlichen Eigenschaften finden Sie unter Geräteeigenschaften.

Audioendpunktgeräte

Programmierverzeichnis