共用方式為


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 呼叫失敗, *ppConnectorNULL

傳回值

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

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

備註

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

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 devicetopology.h

另請參閱

IConnector 介面

IDeviceTopology 介面

IDeviceTopology::GetConnectorCount