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 を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。

リターン コード 説明
E_INVALIDARG
 パラメーター nIndex が範囲外です。
E_POINTER
 ポインター ppConnector は NULL です。

注釈

GetConnector メソッドを呼び出すコード例については、デバイス トポロジの GetHardwareDeviceTopology 関数と SelectCaptureDevice 関数の実装に関するページを参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー devicetopology.h

こちらもご覧ください

IConnector インターフェイス

IDeviceTopology インターフェイス

IDeviceTopology::GetConnectorCount