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

  • Статья

Интерфейс IConnector представляет точку соединения между компонентами. Клиент получает ссылку на интерфейс IConnector путем вызова метода IDeviceTopology::GetConnector или IConnector::GetConnectedTo или путем вызова метода IPart::QueryInterface с параметром iid , равным REFIID IID_IConnector.

Экземпляр интерфейса IConnector может представлять:

  • Аудиоразъем на оборудовании
  • Внутреннее подключение к встроенному устройству конечной точки (например, встроенный микрофон в ноутбуке);
  • Программное подключение, реализованное через передачу DMA
Методы в интерфейсе IConnector могут описывать различные типы соединителей. Соединитель имеет тип (константу перечисления ConnectorType ) и подтип (GUID, полученный из метода IPart::GetSubType ).

Частью топологии устройства может быть соединитель или подъединит. Интерфейс IPart предоставляет методы, которые являются общими для соединителей и подъединитов.

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

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

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

Методы

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

 
IConnector::ConnectTo

Метод ConnectTo подключает этот соединитель к соединителю в другом объекте топологии устройства.
IConnector::D isconnect

Метод Disconnect отключает этот соединитель от другого соединителя.
IConnector::GetConnectedTo

Метод GetConnectedTo получает соединитель, к которому подключен этот соединитель.
IConnector::GetConnectorIdConnectedTo

Метод GetConnectorIdConnectedTo получает глобальный идентификатор соединителя , если таковой имеется, к которому подключен этот соединитель.
IConnector::GetDataFlow

Метод GetDataFlow получает направление потока данных через этот соединитель.
IConnector::GetDeviceIdConnectedTo

Метод GetDeviceIdConnectedTo получает идентификатор звукового устройства, к которому подключен этот соединитель.
IConnector::GetType

Метод GetType получает тип этого соединителя.
IConnector::IsConnected

Метод IsConnected указывает, подключен ли этот соединитель к другому соединителю.

Требования

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

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

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

DeviceTopology API

IConnector::GetConnectedTo

IDeviceTopology::GetConnector