Интерфейс 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