Поделиться через


Свойства конечной точки аудио

Файл заголовка Mmdeviceapi.h определяет несколько свойств устройств конечной точки аудио в Windows Vista и более поздних версиях. Аудиослужба Windows задает значения этих свойств. Клиенты могут читать эти свойства, но не должны задавать их. Значения свойств хранятся в виде структур PROPVARIANT .

Рекомендуемый способ чтения свойств звукового устройства ввода — использовать API в пространстве имен Windows.Devices.Enumeration. Эти API поддерживаются для приложений Магазина Windows и классических приложений. Сведения о существующих классических приложениях, которые считывают свойства устройства с помощью интерфейса IMMDevice, см. в разделе "Свойства устройства". IMMDevice не поддерживается для приложений Магазина Windows.

Примеры кода, показывающие, как получить доступ к свойствам устройства аудио конечной точки, см. в следующих разделах:

Дополнительные сведения о PROPVARIANT см. в документации по пакету SDK для Windows.

Следующие свойства относятся к устройствам аудио конечной точки.

Свойство Description
PKEY_AudioEndpoint_Association Связывает категорию пин-кода потоковой передачи ядра (KS) с устройством конечной точки аудио.
PKEY_AudioEndpoint_ControlPanelPageProvider Задает CLSID зарегистрированного поставщика расширения свойств устройства для устройства конечной точки аудио.
PKEY_AudioEndpoint_Disable_SysFx Указывает, включены ли системные эффекты в потоке общего режима, который передается в устройство звуковой конечной точки или из нее.
PKEY_AudioEndpoint_FormFactor Указывает физические атрибуты устройства аудио конечной точки.
PKEY_AudioEndpoint_FullRangeSpeakers Указывает маску конфигурации канала для динамиков полного диапазона, подключенных к устройству конечной точки аудио.
PKEY_AudioEndpoint_GUID Предоставляет идентификатор устройства DirectSound, соответствующий устройству аудио конечной точки.
PKEY_AudioEndpoint_PhysicalSpeakers Определяет конфигурацию физического динамика для устройства аудио конечной точки.
PKEY_AudioEngine_DeviceFormat Задает формат устройства, который является форматом, используемым обработчиком звука для потока общего режима, который передается в устройство аудио конечной точки или из нее.
PKEY_AudioEngine_OEMFormat Задает формат устройства по умолчанию, который используется для отрисовки или записи потока. Значения заполняются изготовителем оборудования в INF-файле.
PKEY_AudioEndpoint_Supports_EventDriven_Mode Указывает, поддерживает ли конечная точка режим на основе событий. Значения заполняются изготовителем оборудования в INF-файле.
PKEY_AudioEndpoint_JackSubType Содержит GUID выходной категории для устройства аудио конечной точки.

Основные ИНТЕРФЕЙСы API аудио поддерживают дополнительные свойства, которые не применяются исключительно к устройствам конечной точки аудио. Дополнительные сведения об этих дополнительных свойствах см. в разделе "Свойства устройства".

Устройства аудиоконечной точки

Справочник по программированию