IDeviceTopology：：GetConnector 方法 (devicetopology.h)

GetConnector 方法會取得連接器編號所指定的連接器。

語法

HRESULT GetConnector(
  [in]  UINT       nIndex,
  [out] IConnector **ppConnector
);

[in] nIndex

連接器編號。如果裝置拓撲包含 n 個連接器，則連接器編號為 0 到 n – 1。若要取得裝置拓撲中的連接器數目，請呼叫 IDeviceTopology：：GetConnectorCount 方法。

[out] ppConnector

指標變數的指標，方法會寫入連接器物件的 IConnector 介面位址。透過這個方法，呼叫端會取得介面的計數參考。呼叫端負責藉由呼叫介面的 Release 方法，在不再需要介面時釋出介面。如果 GetConnector 呼叫失敗， *ppConnector 為 NULL。

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

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

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