IDeviceTopology：：GetPartById 方法 (devicetopology.h)

GetPartById 方法會取得其本機標識碼所識別的元件。

語法

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

[in] nId

要取得的部分。此參數是元件的本機標識碼。如需詳細資訊，請參閱＜備註＞。

[out] ppPart

指標變數的指標，此方法會寫入 nId 所識別之元件物件的 IPart 介面位址。透過這個方法，呼叫端會取得介面的計數參考。呼叫端負責藉由呼叫介面的 Release 方法，在不再需要介面時釋出介面。如果 GetPartById 呼叫失敗， *ppPart 為 NULL。

如果方法成功，它會傳回 S_OK。如果失敗，可能的傳回碼包括，但不限於下表所示的值。

傳回碼	Description
E_INVALIDARG	參數 nId 不是有效的本機標識碼。
E_POINTER	指標 ppPart 為 NULL。

本機標識碼是一個數位，可唯一識別裝置拓撲中所有元件之間的部分。 IAudioInputSelector：：GetSelection 和 IAudioOutputSelector：：GetSelection 方法會擷取聯機組件的本機標識符。 IAudioInputSelector：：SetSelection 和 IAudioOutputSelector：：SetSelection 方法會選取連接到其本機標識符所識別之元件的輸入或輸出。當您有元件物件的指標時，您可以呼叫 IPart：：GetLocalId 方法來取得元件的本機識別碼。