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
标头 devicetopology.h

另请参阅

IConnector 接口