ICaptureGraphBuilder2::FindInterface

[アーティクル]
04/22/2010

FindInterface メソッドは、指定されたフィルタから始めて、指定されたインターフェイスをグラフ内で検索する。検索は、フィルタのアップストリームまたはダウンストリームのグラフのセクションに限定したり、特定のピンカテゴリまたはメディアタイプに限定したりできる。

構文

  HRESULT FindInterface(
  const GUID *pCategory,
  const GUID *pType,
  IBaseFilter *pf,
  REFIID riid,
  void **ppint
);

パラメータ

pCategory

[in] 検索条件を指定する GUID へのポインタ。詳細については、「注意」を参照すること。指定できる値は次のとおりである。

&LOOK_UPSTREAM_ONLY
&LOOK_DOWNSTREAM_ONLY
ピンカテゴリを指定する、ピンプロパティセットの AMPROPERTY_PIN_CATEGORY 構造体のメンバへのポインタ。
NULL

詳細については、「注意」を参照すること。

pType

[in] 出力ピンのメジャーメディアタイプを指定する GUID へのポインタまたは NULL。

[in] フィルタの IBaseFilter インターフェイスへのポインタ。メソッドは、このフィルタから検索を開始する。

riid

[in] 検索するインターフェイスのインターフェイス識別子 (IID) へのポインタ。

ppint

[out] インターフェイスポインタを受け取る変数のアドレス。インターフェイスを使った後は、取得したインターフェイスポインタを必ず解放すること。

戻り値

HRESULT 値を返す。可能な値は次のとおりである。

戻りコード	説明
S_OK	成功。
E_FAIL	失敗。
E_NOINTERFACE	そのインターフェイスはサポートされていない。
E_POINTER	NULL ポインタ引数。

注意

キャプチャグラフでは、さまざまなフィルタおよびピンが、圧縮引数 (IAMVideoCompression) やストリームフォーマット (IAMStreamConfig) などのプロパティを設定するインターフェイスを公開する可能性がある。キャプチャデバイスによっては、他の有用なインターフェイスがアナログ信号のルーティングを行う IAMCrossbarや、TV チューナーデバイスを制御する IAMTVTuner を含んでいる可能性がある。このメソッドを使えば、グラフを対象に検索を行うための特殊なコードを書かなくても、インターフェイスを検索できる。

重要 :** IVideoWindow** インターフェイスポインタを取得するときは、このメソッドを呼び出してはならない。その場合は、フィルタグラフマネージャにこのインターフェイスの有無を問い合わせること。そうしないと、フィルタグラフマネージャは、画面解像度およびその他のイベントに正しく反応しなくなる。

pCategory 引数が NULL の場合、このメソッドは、グラフ全体を対象として要求されたインターフェイスを検索する。このメソッドは、pf 引数によって指定されたフィルタから始めて、グラフ内で次のオブジェクトに問い合わせる

フィルタ
フィルタのピン
フィルタのピンを含むすべてのダウンストリームフィルタ
フィルタのピンを含むすべてのアップストリームフィルタ

次のように pCategory 引数と pType 引数を設定することにより、検索を限定できる。

pCategory が &LOOK_UPSTREAM_ONLY の場合、検索はフィルタの入力ピンから始まって、アップストリーム方向に継続する。フィルタ自体やフィルタのダウンストリームにあるものは検索の対象にならない。pType 引数は無視される。
pCategory が &LOOK_DOWNSTREAM_ONLY の場合、検索はフィルタの出力ピンから始まって、ダウンストリーム方向に継続する。フィルタ自体やフィルタのアップストリームにあるものは検索の対象にならない。pType 引数は無視される。
pCategory がピンカテゴリを指定している場合、検索のダウンストリームの部分は、ピンカテゴリと pType 引数によって指定されるメディアタイプの両方が一致するフィルタの出力ピンに限定される。その場合、メソッドは、フィルタおよびフィルタのアップストリームにあるすべてのものも検索する。

ピンカテゴリは、キャプチャフィルタのピンインターフェイスを検索するときに役立つ。たとえば、キャプチャフィルタは、キャプチャ用とプレビュー用の別々のピンを備えていることがある。ピンカテゴリを指定する場合は、メソッドが正しいフィルタとピンを選択できるように、メディアタイプも指定する必要がある。

一部のビデオキャプチャフィルタは、プレビューピンの代わりにビデオポートピン (PIN_CATEGORY_VIDEOPORT) を備えている。PIN_CATEGORY_PREVIE と MEDIATYPE_Video を指定すると、メソッドは、すべてのビデオポートピンをプレビューピンとして扱う。アプリケーションでこの可能性をテストする必要はない。

**サポートするフィルタ。**キャプチャデバイスが Windows Driver Model (WDM) ドライバを使う場合、グラフは、TV チューナーフィルタやアナログビデオクロスバーフィルタなど、WDM ビデオキャプチャフィルタのアップストリームにある特定のフィルタを必要とすることがある。グラフがこれらの WDM フィルタのいずれかを必要とする場合、このメソッドは自動的にそれらのフィルタをグラフに挿入する。メソッドは、キャプチャフィルタの入力ピンに問い合わせて、入力ピンがサポートするメディアを判別し、それらのメディアを適合するフィルタに接続する。

参照

ICaptureGraphBuilder2::FindInterface

その他のリソース