Dela via


Egenskaper för ljudslutpunkt

Huvudfilen Mmdeviceapi.h definierar flera egenskaper för ljudslutpunktsenheter i Windows Vista och senare. Windows-ljudtjänsten anger värdena för dessa egenskaper. Klienter kan läsa dessa egenskaper, men bör inte ange dem. Egenskapsvärden lagras som PROPVARIANT- strukturer.

Det rekommenderade sättet att läsa egenskaperna för en ljudinmatningsenhet är att använda API:erna i Windows.Devices.Uppräkning namnrymd. Dessa API:er stöds för Windows Store-appar och skrivbordsappar. Befintliga skrivbordsappar som läser enhetsegenskaper med hjälp av gränssnittet IMMDevice finns i Enhetsegenskaper. IMMDevice stöds inte för Windows Store-appar.

Kodexempel som visar hur du får åtkomst till egenskaperna för en ljudslutpunktsenhet finns i följande avsnitt:

Information om PROPVARIANT-finns i Windows SDK-dokumentationen.

Följande egenskaper är specifika för ljudslutpunktsenheter.

Egenskap Beskrivning
PKEY_AudioEndpoint_Association Associerar en KS-pin-kategori (kernel-streaming) med en ljudslutpunktsenhet.
PKEY_AudioEndpoint_ControlPanelPageProvider Anger CLSID för den registrerade providern för enhetsegenskaper-tillägget för ljudslutpunktsenheten.
PKEY_AudioEndpoint_Disable_SysFx Anger om systemeffekter är aktiverade i dataströmmen i delat läge som flödar till eller från ljudslutpunktsenheten.
PKEY_AudioEndpoint_FormFactor Anger de fysiska attributen för ljudslutpunktsenheten.
PKEY_AudioEndpoint_FullRangeSpeakers Anger kanalkonfigurationsmasken för alla högtalare som är anslutna till ljudslutpunktsenheten.
PKEY_AudioEndpoint_GUID Tillhandahåller DirectSound-enhetsidentifieraren som motsvarar ljudslutpunktsenheten.
PKEY_AudioEndpoint_PhysicalSpeakers Definierar den fysiska talarkonfigurationen för ljudslutpunktsenheten.
PKEY_AudioEngine_DeviceFormat Anger enhetsformatet, vilket är det format som ljudmotorn använder för strömmen i delat läge som flödar till eller från ljudslutpunktsenheten.
PKEY_AudioEngine_OEMFormat Anger standardformatet för den enhet som används för återgivning eller insamling av en ström. Värdena fylls i av OEM-tillverkaren i en .inf-fil.
PKEY_AudioEndpoint_Supports_EventDriven_Mode Anger om slutpunkten stöder händelsestyrt läge. Värdena fylls i av OEM-tillverkaren i en .inf-fil.
PKEY_AudioEndpoint_JackSubType Innehåller en utdatakategori-GUID för en ljudslutpunktsenhet.

Api:erna för kärnljud stöder ytterligare egenskaper som inte endast gäller för ljudslutpunktsenheter. Mer information om dessa ytterligare egenskaper finns i Enhetsegenskaper.

ljudslutpunktsenheter

programmeringsreferens