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 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.