ICaptureGraphBuilder::FindInterface メソッド (strmif.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
構文
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 を含む) |