Share via

iPartsList：：GetPart 方法 (devicetopology.h)

  • 项目

GetPart 方法从部件列表中获取部件。

语法

HRESULT GetPart(
  [in]  UINT  nIndex,
  [out] IPart **ppPart
);

参数

[in] nIndex

要检索的部件的部件号。 如果部件列表包含 n 个 部件，则部件的编号为 0 到 n – 1。 调用 IPartsList：：GetCount 方法以获取列表中的部件数。

[out] ppPart

指向指针变量的指针，方法将部件对象的 IPart 接口的地址写入其中。 通过此方法，调用方获取对 IPart 接口的计数引用。 调用方负责通过调用接口的 Release 方法，在不再需要接口时释放接口。 如果 GetPart 调用失败， 则 *ppPart 为 NULL。

返回值

如果该方法成功，则它会返回 S_OK。 如果失败，可能的返回代码包括但不限于下表中显示的值。

返回代码 说明
E_INVALIDARG
 参数 nIndex 在范围外。
E_POINTER
 指针 ppPart 为 NULL。

注解

有关调用 GetPart 方法的代码示例，请参阅 设备拓扑中 SelectCaptureDevice 函数的实现。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 devicetopology.h

另请参阅

IPart 接口

IPartsList 接口

IPartsList：：GetCount