IPartsList::GetPart メソッド (devicetopology.h)

  • [アーティクル]

GetPart メソッドは、パーツ一覧からパーツを取得します。

構文

HRESULT GetPart(
  [in]  UINT  nIndex,
  [out] IPart **ppPart
);

パラメーター

[in] nIndex

取得するパーツの部品番号。 パーツ一覧に n 個の部分が含まれている場合、パーツには 0 から n – 1 の番号が付きます。 リスト内のパーツ数を取得するには、 IPartsList::GetCount メソッドを呼び出します。

[out] ppPart

メソッドが part オブジェクトの IPart インターフェイスのアドレスを書き込むポインター変数へのポインター。 このメソッドを使用して、呼び出し元は IPart インターフェイスへのカウントされた参照を取得します。 呼び出し元は、インターフェイスの Release メソッドを呼び出すことによって、不要になったときにインターフェイスを 解放 する役割を担います。 GetPart 呼び出しが失敗した場合、*ppPart は NULL です。

戻り値

メソッドが成功した場合は、S_OK を返します。 失敗した場合、次の表に示す値が含まれますが、これに限定されません。

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

注釈

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

要件

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

こちらもご覧ください

IPart インターフェイス

IPartsList インターフェイス

IPartsList::GetCount