IDeviceTopology：：GetPartById 方法 (devicetopology.h)

项目
03/05/2024

GetPartById 方法获取由其本地 ID 标识的部件。

语法

HRESULT GetPartById(
  [in]  UINT  nId,
  [out] IPart **ppPart
);

参数

[in] nId

要获取的部分。此参数是部件的本地 ID。有关详细信息，请参阅“备注”。

[out] ppPart

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

返回值

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

返回代码	说明
E_INVALIDARG	参数 nId 不是有效的本地 ID。
E_POINTER	指针 ppPart 为 NULL。

注解

本地 ID 是一个数字，用于唯一标识设备拓扑中所有部件中的某个部件。 IAudioInputSelector：：GetSelection 和 IAudioOutputSelector：：GetSelection 方法检索连接的部件的本地 ID。 IAudioInputSelector：：SetSelection 和 IAudioOutputSelector：：SetSelection 方法选择连接到由其本地 ID 标识的部件的输入或输出。当具有指向部件对象的指针时，可以调用 IPart：：GetLocalId 方法来获取部件的本地 ID。

要求

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