次の方法で共有


ICaptureGraphBuilder::FindInterface メソッド (strmif.h)

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayerIMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayerIMFMediaEngineAudio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

メモICaptureGraphBuilder インターフェイスは非推奨です。 代わりに ICaptureGraphBuilder2 を使用してください。
 
フィルター、フィルターのアップストリームとダウンストリームで指定されたインターフェイスを検索し、必要に応じて、特定のカテゴリの出力ピンでのみ検索します。

構文

HRESULT FindInterface(
  [in]  const GUID  *pCategory,
  [in]  IBaseFilter *pf,
  [in]  REFIID      riid,
  [out] void        **ppint
);

パラメーター

[in] pCategory

出力ピン カテゴリを指定する GUID へのポインター。 すべてのピン カテゴリの一覧については、「 Pin プロパティ セット 」を参照してください。 NULL は 、カテゴリに関係なくすべての出力ピンを検索します。

[in] pf

フィルターの IBaseFilter インターフェイスへのポインター。

[in] riid

目的のインターフェイスの参照 ID。

[out] ppint

void ポインターのアドレス。 インターフェイスが見つかった場合、このメソッドは ppint を初期化して、見つかったインターフェイスへのポインターのアドレスを格納します。 インターフェイスの使用が完了したら、 Release メソッドを呼び出して参照カウントをデクリメントします。

戻り値

HRESULT 値を返します。

注釈

このメソッドは、カテゴリが指定されていない限り、フィルターのインターフェイス、およびフィルターのアップストリームとダウンストリームを検索します。 カテゴリが指定されている場合は、そのカテゴリの出力ピンの下流にのみ表示されます。 レンダラー、マルチプレクサー、TV チューナ、クロスバーなどのインターフェイスを検索するために使用できます。

pCategory が &LOOK_UPSTREAM_ONLY と等しい場合、グラフ ビルダーはパラメーター pf で指定されたフィルターの上流を検索しますが、フィルター自体やフィルターのダウンストリームには表示されません。

pCategory が &LOOK_DOWNSTREAM_ONLY と等しい場合、グラフ ビルダーはパラメーター pf で指定されたフィルターの下流を検索しますが、フィルター自体やフィルターの上流には表示されません。

要件

要件
対象プラットフォーム Windows
ヘッダー strmif.h (Dshow.h を含む)

こちらもご覧ください

エラーコードと成功コード

ICaptureGraphBuilder インターフェイス