Udostępnij za pośrednictwem

Właściwości punktu końcowego audio

Plik nagłówka Mmdeviceapi.h definiuje kilka właściwości urządzeń punktu końcowego audio w systemie Windows Vista i nowszych. Usługa audio systemu Windows ustawia wartości tych właściwości. Klienci mogą odczytywać te właściwości, ale nie powinni ich ustawiać. Wartości właściwości są przechowywane jako struktury PROPVARIANT.

Zalecanym sposobem odczytywania właściwości urządzenia wejściowego audio jest użycie interfejsów API w Windows.Devices.Enumeration przestrzeni nazw. Te interfejsy API są obsługiwane w przypadku aplikacji ze Sklepu Windows i aplikacji klasycznych. W przypadku istniejących aplikacji klasycznych, które odczytują właściwości urządzenia przy użyciu interfejsu IMMDevice, zobacz Właściwości urządzenia. IMMDevice nie jest obsługiwana w przypadku aplikacji ze Sklepu Windows.

Przykłady kodu pokazujące, jak uzyskać dostęp do właściwości urządzenia punktu końcowego audio, zobacz następujące tematy:

Aby uzyskać informacje na temat PROPVARIANT, zobacz dokumentację zestawu Windows SDK.

Poniższe właściwości są specyficzne dla urządzeń punktu końcowego audio.

Własność Opis
PKEY_AudioEndpoint_Association Kojarzy kategorię pinezki przesyłania strumieniowego jądra (KS) z urządzeniem punktu końcowego audio.
PKEY_AudioEndpoint_ControlPanelPageProvider Określa identyfikator CLSID zarejestrowanego dostawcy rozszerzenia właściwości urządzenia dla urządzenia punktu końcowego audio.
PKEY_AudioEndpoint_Disable_SysFx Wskazuje, czy efekty systemowe są włączone w strumieniu trybu udostępnionego, który przepływa do lub z urządzenia punktu końcowego audio.
PKEY_AudioEndpoint_FormFactor Wskazuje atrybuty fizyczne urządzenia punktu końcowego audio.
PKEY_AudioEndpoint_FullRangeSpeakers Określa maskę konfiguracji kanału dla głośników z pełnym zakresem podłączonych do urządzenia punktu końcowego audio.
PKEY_AudioEndpoint_GUID Dostarcza identyfikator urządzenia DirectSound odpowiadający urządzeniu punktu końcowego audio.
PKEY_AudioEndpoint_PhysicalSpeakers Definiuje konfigurację fizycznego głośnika dla urządzenia punktu końcowego audio.
PKEY_AudioEngine_DeviceFormat Określa format urządzenia, który jest formatem używanym przez aparat audio dla strumienia trybu udostępnionego, który przepływa do lub z urządzenia punktu końcowego audio.
PKEY_AudioEngine_OEMFormat Określa domyślny format urządzenia, który jest używany do renderowania lub przechwytywania strumienia. Wartości są wypełniane przez producenta OEM w pliku inf.
PKEY_AudioEndpoint_Supports_EventDriven_Mode Wskazuje, czy punkt końcowy obsługuje tryb sterowany zdarzeniami. Wartości są wypełniane przez producenta OEM w pliku inf.
PKEY_AudioEndpoint_JackSubType Zawiera identyfikator GUID kategorii danych wyjściowych dla urządzenia punktu końcowego audio.

Podstawowe interfejsy API audio obsługują dodatkowe właściwości, które nie mają zastosowania wyłącznie do urządzeń punktów końcowych audio. Aby uzyskać więcej informacji na temat tych dodatkowych właściwości, zobacz Właściwości urządzenia.

urządzenia punktu końcowego audio

programowania