Audioendpunkteigenschaften

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 über die IMMDevice-Schnittstelle lesen, finden Sie unter Geräteeigenschaften. IMMDevice wird für Windows Store-Apps nicht unterstützt.

Codebeispiele für den Zugriff 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 gelten spezifisch für Audioendpunktgeräte.

Eigenschaft BESCHREIBUNG
PKEY _ _ AudioEndpoint-Zuordnung Ordnet einem Audioendpunktgerät eine Kernelstreaming-Pinkategorie (KS) 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 Stream im freigegebenen Modus aktiviert sind, der an das Audioendpunktgerät oder vom Audioendpunktgerät übertragen wird.
PKEY _ AudioEndpoint _ FormFactor Gibt die physischen Attribute des Audioendpunktgeräts an.
PKEY _ AudioEndpoint _ FullRangeSpeakers Gibt die Kanalkonfigurationsmaske für die Vollbereichslautgeber an, die mit dem Audioendpunktgerät verbunden sind.
PKEY _ AudioEndpoint _ GUID Gibt den DirectSound-Gerätebezeichner an, 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 Streams verwendet wird. Die Werte werden vom OEM in einer INF-Datei aufgefüllt.
PKEY _ AudioEndpoint _ unterstützt den _ EventDriven-Modus. _
Gibt an, ob der Endpunkt den ereignisgesteuerten Modus unterstützt. Die Werte werden vom OEM in einer INF-Datei aufgefüllt.

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