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. Vorhandene 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, die zeigen, wie Sie auf die Eigenschaften eines Audioendpunktgeräts zugreifen, 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.
| Eigentum | Beschreibung |
|---|---|
| PKEY_AudioEndpoint_Association | Ordnet eine KS-Pinkategorie (Kernel-Streaming) 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 Datenstrom für den gemeinsam genutzten Modus aktiviert sind, der an das Audioendpunktgerät 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 physische Lautsprecherkonfiguration für das Audioendpunktgerät. |
| PKEY_AudioEngine_DeviceFormat | Gibt das Geräteformat an, bei dem es sich um das Format handelt, das das Audiomodul für den Stream für den gemeinsam genutzten Modus verwendet, der zum oder vom Audioendpunktgerät fließt. |
| PKEY_AudioEngine_OEMFormat | Gibt das Standardformat des Geräts an, das zum Rendern oder Aufzeichnen 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 wichtigsten Audio-APIs unterstützen zusätzliche Eigenschaften, die nicht ausschließlich auf Audioendpunktgeräte angewendet werden. Weitere Informationen zu diesen zusätzlichen Eigenschaften finden Sie unter Device Properties.