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。如果失敗，可能的傳回碼包括，但不限於下表所示的值。

傳回碼	Description
E_INVALIDARG	參數 nIndex 超出範圍。
E_POINTER	指標 ppPart 為 NULL。

如需呼叫 GetPart 方法的程式代碼範例，請參閱裝置拓撲中的 SelectCaptureDevice 函式實作。