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。 如果失败,可能的返回代码包括但不限于下表中显示的值。
返回代码 | 说明 |
---|---|
|
参数 nIndex 在范围外。 |
|
指针 ppConnector 为 NULL。 |
注解
有关调用 GetConnector 方法的代码示例,请参阅 设备拓扑中 GetHardwareDeviceTopology 和 SelectCaptureDevice 函数的实现。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | devicetopology.h |