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。