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


Интерфейс IDeviceTopology (devicetopology.h)

Интерфейс IDeviceTopology предоставляет доступ к топологии звукового устройства. Топология устройства аудиоадаптера состоит из путей данных, которые ведут к конечным звуковым устройствам и от нее, а также контрольных точек, расположенных вдоль путей. Устройство конечной точки звука также имеет топологию, но она тривиальна, как описано в разделе Топологии устройств. Клиент получает ссылку на интерфейс IDeviceTopology для устройства конечной точки аудио, выполнив следующие действия:

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

Примеры кода, использующие интерфейс IDeviceTopology , см. в реализации функций GetHardwareDeviceTopology и SelectCaptureDevice в топологиях устройств.

Наследование

Интерфейс IDeviceTopology наследуется от интерфейса IUnknown . IDeviceTopology также имеет следующие типы элементов:

Методы

Интерфейс IDeviceTopology содержит следующие методы.

 
IDeviceTopology::GetConnector

Метод GetConnector получает соединитель, указанный номером соединителя.
IDeviceTopology::GetConnectorCount

Метод GetConnectorCount получает количество соединителей в объекте device-topology.
IDeviceTopology::GetDeviceId

Метод GetDeviceId получает идентификатор устройства, представленного объектом топологии устройства.
IDeviceTopology::GetPartById

Метод GetPartById получает часть, определяемую локальным идентификатором.
IDeviceTopology::GetSignalPath

Метод GetSignalPath получает список частей в пути сигнала, который связывает две части, если путь существует.
IDeviceTopology::GetSubunit

Метод GetSubunit получает подсоединение, указанное номером вложенной единицы.
IDeviceTopology::GetSubunitCount

Метод GetSubunitCount получает количество вложенных единиц в топологии устройства.

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header devicetopology.h

См. также раздел

Основные звуковые интерфейсы

DeviceTopology API

IMMDevice::Activate