IDeviceTopology：：GetSubunit 方法 (devicetopology.h)

GetSubunit 方法获取由子单位编号指定的子单位。

语法

HRESULT GetSubunit(
  [in]  UINT     nIndex,
  [out] ISubunit **ppSubunit
);

[in] nIndex

子单位数。如果设备拓扑包含 n 个子单元，则子单元的编号从 0 到 n– 1。若要获取设备拓扑中的子单元数，请调用 IDeviceTopology：：GetSubunitCount 方法。

[out] ppSubunit

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

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

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