IPart::EnumPartsIncoming メソッド (devicetopology.h)

  • [アーティクル]

EnumPartsIncoming メソッドは、すべての受信パーツ (つまり、このパーツから上流にあるデータ パスに存在する部分) の一覧を取得します。

構文

HRESULT EnumPartsIncoming(
  [out] IPartsList **ppParts
);

パラメーター

[out] ppParts

メソッドが IPartsList インターフェイスのアドレスを書き込むポインター変数へのポインター。この部分からすぐに上流にあるパーツのリストをカプセル化します。 このメソッドを使用して、呼び出し元はインターフェイスへのカウントされた参照を取得します。 呼び出し元は、インターフェイスの Release メソッドを呼び出すことによって、不要になったインターフェイスを解放する必要があります。 EnumPartsIncoming 呼び出しが失敗した場合、*ppParts は NULL です。

戻り値

メソッドが成功した場合は、S_OK を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。

リターン コード 説明
E_POINTER
 ポインター ppParts は NULL です。
E_NOTFOUND
 このパーツには、アップストリーム パーツへのリンクはありません。
E_OUTOFMEMORY
 メモリが不足しています。

注釈

クライアント アプリケーションは、トラバーサルの各ステップでこのメソッドを繰り返し呼び出して、現在のパーツからすぐに上流にあるパーツの一覧を取得することで、オーディオ データ フローの方向に対してデバイス トポロジを走査できます。

このパーツにアップストリーム パーツへのリンクがない場合、メソッドはエラー コード E_NOTFOUNDを返し、パーツ 一覧を作成しません (*ppParts は NULL です)。 たとえば、 IPart インターフェイスが、データがデバイス トポロジに入るコネクタを表す場合、メソッドはこのエラー コードを返します。

要件

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

こちらもご覧ください

IPart インターフェイス

IPartsList インターフェイス