DeviceTopology API

Ознакомьтесь с примером DMO для записи голосовых данных Майкрософт высокого качества.

API DeviceTopology предоставляет клиентские приложения с возможностью обхода функциональных аппаратных топологий устройств отрисовки и записи звука. Через интерфейсы и методы в API DeviceTopology клиенты могут обнаруживать функциональные подсоедины (например, управление томами), которые лежат вдоль путей данных, которые приводят к устройствам конечной точки аудио и из нее. Клиенты могут проходить внутренние топологии устройств аудиоадаптера и конечных точек звука и выполнять шаги между подключениями, которые связывают одно устройство с другим. Дополнительные сведения см. в разделе "Топологии устройств".

Файл заголовка Devicetopology.h определяет интерфейсы в API DeviceTopology.

Чтобы получить доступ к интерфейсам API DeviceTopology, клиент сначала получает ссылку на интерфейс IDeviceTopology для устройства аудио конечной точки, выполнив следующие действия:

1. Используя один из методов, описанных в интерфейсе IMMDevice, получите ссылку на интерфейс IMMDevice для устройства аудио конечной точки.
2. Вызовите метод IMMDevice::Activate с параметром iid, равным REFIID IID_IDeviceTopology.

Клиент может получить ссылки на другие интерфейсы в API DeviceTopology, вызвав методы в интерфейсе IDeviceTopology .

API DeviceTopology реализует следующие интерфейсы.

Интерфейс	Description
IAudioAutoGainControl	Предоставляет доступ к аппаратному автоматическому управлению получением (AGC).
IAudioBass	Предоставляет доступ к аппаратному элементу управления басового уровня.
IAudioChannelConfig	Предоставляет доступ к элементу управления конфигурации канала оборудования.
IAudioInputSelector	Предоставляет доступ к аппаратному элементу управления мультиплексором (селектор ввода).
IAudioLoudness	Предоставляет доступ к контролю за "громкость" компенсации.
IAudioMidrange	Предоставляет доступ к аппаратному элементу управления среднего уровня.
IAudioMute	Предоставляет доступ к аппаратному элементу управления выключения.
IAudioOutputSelector	Предоставляет доступ к аппаратному элементу управления demultiplexer (селектор вывода).
IAudioPeakMeter	Предоставляет доступ к аппаратному элементу управления пикового измерения.
IAudioTreble	Предоставляет доступ к аппаратному элементу управления с трепетным уровнем.
IAudioVolumeLevel	Предоставляет доступ к аппаратному элементу управления томами.
I Подключение or	Представляет точку соединения между компонентами.
IControlInterface	Представляет интерфейс элемента управления (подъединений или соединителя).
IDeviceSpecificProperty	Представляет свойство для конкретного устройства соединителя или подъединения.
IDeviceTopology	Предоставляет доступ к топологии звукового устройства.
IKsFormatSupport	Предоставляет сведения о форматах аудиоданных, поддерживаемых программным подключением ввода-вывода (обычно канал DMA) между звуковым устройством и системной памятью.
IKsJackDescription	Предоставляет сведения о разъемах или внутренних соединителях, которые обеспечивают физическое подключение между устройством на звуковом адаптере и внешнем или внутреннем устройстве конечной точки (например, микрофоном или проигрывателем компакт-дисков).
Параметрической детали	Представляет часть (соединитель или подсеть) топологии устройства.
IPartsList	Представляет список частей (соединителей и вложенных элементов).
IPerChannelDbLevel	Представляет универсальный интерфейс управления подсоединения, обеспечивающий управление на уровне громкости в децибелях аудиопотока или полосы частоты в звуковом потоке.
ISubunit	Представляет аппаратный подсоединение (например, элемент управления уровня тома), который находится в пути к данным между клиентом и устройством аудио конечной точки.

 

Клиенты API DeviceTopology, требующие уведомления о событиях изменения элемента управления в соединителях и подъединениях, должны реализовать следующий интерфейс.

Интерфейс	Description
IControlChangeNotify	Предоставляет уведомления при изменении состояния части (соединителя или подъединения).

 

См. также

Топологии устройств

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