Метод IDeviceTopology::GetConnector (devicetopology.h)

  • Статья

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

Синтаксис

HRESULT GetConnector(
  [in]  UINT       nIndex,
  [out] IConnector **ppConnector
);

Параметры

[in] nIndex

Номер соединителя. Если топология устройства содержит n соединителей, соединители нумеруются от 0 до n – 1. Чтобы получить количество соединителей в топологии устройства, вызовите метод IDeviceTopology::GetConnectorCount .

[out] ppConnector

Указатель на переменную указателя, в которую метод записывает адрес интерфейса IConnector объекта соединителя. С помощью этого метода вызывающий объект получает подсчитываемую ссылку на интерфейс. Вызывающий объект отвечает за освобождение интерфейса, когда он больше не нужен, путем вызова метода Release интерфейса. Если вызов GetConnector завершается сбоем, *ppConnector имеет значение NULL.

Возвращаемое значение

Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, но не ограничиваются ими, значения, показанные в следующей таблице.

Код возврата Описание
E_INVALIDARG
 Параметр nIndex выходит за пределы диапазона.
E_POINTER
 Указатель ppConnector имеет значение NULL.

Комментарии

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

Требования

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

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

Интерфейс IConnector

Интерфейс IDeviceTopology

IDeviceTopology::GetConnectorCount