Метод IConnector::GetConnectedTo (devicetopology.h)

  • Статья

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

Синтаксис

HRESULT GetConnectedTo(
  [out] IConnector **ppConTo
);

Параметры

[out] ppConTo

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

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

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

Код возврата Описание
E_POINTER
 Указатель ppConTo имеет значение NULL.
E_NOTFOUND
 Этот соединитель не подключен или другая сторона подключения не является другой топологией устройства (например, подключением Software_IO).
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
 Топология устройства на другой стороне подключения неактивна (то есть состояние устройства не DEVICE_STATE_ACTIVE).

Комментарии

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

Сведения о Software_IO подключениях см. в разделе Перечисление ConnectorType. Сведения о макросе HRESULT_FROM_WIN32 см. в документации по Windows SDK. Сведения о состоянии устройства DEVICE_STATE_NOTPRESENT см. в разделе Константы DEVICE_STATE_XXX.

Требования

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

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

Интерфейс IConnector