ICaptureGraphBuilder

注意 このインターフェイスは非推奨です。(ICaptureGraphBuilder)

注意 ICaptureGraphBuilder インターフェイスは非推奨です。代わりに ICaptureGraphBuilder2 を使用してください。グラフビルダーオブジェクトに、使用するフィルターグラフを指定します。

HRESULT 値を返します。

このメソッドを呼び出さない場合、グラフビルダーは自動的にフィルターグラフを作成します。グラフビルダーが独自のフィルターグラフを作成した後にこのメソッドを呼び出すと、呼び出しは失敗します。

注意 ICaptureGraphBuilder インターフェイスは非推奨です。代わりに ICaptureGraphBuilder2 を使用してください。ビルダーが使用しているフィルターグラフを取得します。

HRESULT 値を返します。

このメソッドは IGraphBuilder インターフェイスの参照カウントをインクリメントします。Release メソッドを呼び出して IGraphBuilder の参照カウントを必ずデクリメントしてください。

注意 ICaptureGraphBuilder インターフェイスは非推奨です。代わりに ICaptureGraphBuilder2 を使用してください。指定したファイル名でビットをディスクに保存する、フィルターグラフのレンダリング部分を作成します。

HRESULT 値を返します。取り得る値には次のものがあります。

このメソッドは、マルチプレクサーとファイルライターをフィルターグラフに挿入し、IFileSinkFilter::SetFileName を呼び出して出力ファイル名を設定します。

このメソッドが返す ppf パラメーターは、RenderStream の呼び出しで pfRenderer パラメーターとして使用できます。

このメソッドの pSink パラメーターは、SetFileName の呼び出しで使用して、ICaptureGraphBuilder::SetOutputFileName が設定したファイル名を変更できます。

注意 ICaptureGraphBuilder インターフェイスは非推奨です。代わりに ICaptureGraphBuilder2 を使用してください。指定したインターフェイスを、フィルター上、およびフィルターの上流と下流で検索します。また、必要に応じて、指定したカテゴリの出力ピンのみで検索します。

HRESULT 値を返します。

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

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

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

注意 ICaptureGraphBuilder インターフェイスは非推奨です。代わりに ICaptureGraphBuilder2 を使用してください。ソースフィルターのピン(必要に応じてカテゴリを指定)をレンダリングフィルターに接続します。必要に応じて、別のフィルターを経由して接続します。

キャプチャフィルターにキャプチャピンはあるがプレビューピンがなく、そのキャプチャピンに対して &PIN_CATEGORY_PREVIEW カテゴリを指定して RenderStream を呼び出した場合、VFW_S_NOPREVIEWPIN を返します。この場合、RenderStream は Smart Tee フィルターのプレビューピンをレンダリングします。詳細については、「解説」を参照してください。

pCategory に NULL 以外の Pin Property Set GUID を指定し、pSource にキャプチャフィルターを指定した場合、このメソッドは、TV チューナーやクロスバーなど、必要な追加の上流フィルターをインスタンス化して接続します。その後、pSource のキャプチャピンをレンダリングします。

pSource がピンの場合は、pCategory に NULL を指定します。このメソッドはそのピンからストリームをレンダリングします。

ソースフィルターに出力ピンが 1 つしかない場合は、pCategory に NULL を指定します。

パラメーターとして指定する pSource、pfCompressor、pfRenderer の各フィルターは、このメソッドを呼び出す前にグラフ内に存在している必要があります。

WDM キャプチャフィルターを使用するキャプチャグラフを構築する場合、このメソッドは、下流フィルターだけでなく、必要なすべての上流フィルターも構築します。

新しい WDM VPE(Video Port Extension)ビデオキャプチャハードウェアで動作する一部のキャプチャフィルターは、プレビュー用のプレビューピンではなく、ビデオポートピンを備えています。ビデオポートピンはビデオレンダラーに直接接続されず、代わりに Overlay Mixer と呼ばれる特殊なフィルターに接続されます。アプリケーションでこれを気にする必要はありません。PIN_CATEGORY_PREVIEW を指定して RenderStream を呼び出すだけで、必要であればキャプチャグラフビルダーがオーバーレイミキサーを経由して VIDEO PORT ピンを正しくレンダリングします。

ビデオキャプチャフィルターのキャプチャピンまたはプレビューピンをレンダリングする際に(PIN_CATEGORY_CAPTURE または PIN_CATEGORY_PREVIEW カテゴリを指定して RenderStream を使用)、キャプチャフィルターにキャプチャピンはあるがプレビューピンがない場合、キャプチャとプレビューを同時に行えるように Smart Tee フィルターが自動的に使用されます。たとえば、PIN_CATEGORY_CAPTURE カテゴリを指定して RenderStream を呼び出すと、実際にはフィルターのキャプチャピンに Smart Tee フィルターが接続され、その Smart Tee のキャプチャピンがレンダリングされます。その後、そのキャプチャピンに対して PIN_CATEGORY_PREVIEW カテゴリを指定して RenderStream を呼び出すと、実際には Smart Tee のプレビューピンがレンダリングされます。PIN_CATEGORY_PREVIEW を指定した RenderStream の呼び出しでキャプチャピンと Smart Tee フィルターが使用された場合、RenderStream はそれを示すために VFW_S_NOPREVIEWPIN を返します。したがって、FindInterface がプレビューインターフェイスを見つけられない場合は、プレビューインターフェイスがキャプチャフィルターのキャプチャピンの下流を調べることで見つかる可能性があるため、PIN_CATEGORY_PREVIEW カテゴリと PIN_CATEGORY_CAPTURE カテゴリの両方で FindInterface を呼び出す必要がある場合があります。

注意 ICaptureGraphBuilder インターフェイスは非推奨です。代わりに ICaptureGraphBuilder2 を使用してください。グラフ内の 1 つ以上のキャプチャフィルターにおける、指定したカテゴリのピンにストリーム制御メッセージを送信します。

キャプチャフィルターが送信した最後のサンプルがレンダリングされる前に停止通知が送信された場合は S_FALSE を返し、それ以外の場合は S_OK を返します。

このメソッドが S_FALSE を返した場合、アプリケーションは、すべてのサンプルがグラフを通過してレンダリングされるように、フィルターグラフを停止する前に待機した方がよい場合があります。そうしないと、サンプルが失われる可能性があります。

指定した記述に一致するピンがない場合、または指定したすべてのピンでストリーム制御をサポートできない場合、この関数は失敗コードを返します。

フレーム単位で正確なキャプチャを行う場合や、キャプチャとプレビューを個別に制御する場合に、このメソッドを使用します。たとえば、キャプチャした画像をプレビューするだけの場合は、キャプチャした画像のディスクへの書き込みをオフにできます。

このメソッドは、ピン上の IAMStreamControl インターフェイスを使用します。

このメソッドは、指定したカテゴリのピンを持つフィルターが見つかるたびに 1 つの通知を送信します。

注意 ICaptureGraphBuilder インターフェイスは非推奨です。代わりに ICaptureGraphBuilder2 を使用してください。キャプチャファイルを指定したサイズで事前に割り当てます。

HRESULT 値を返します。

ファイルが読み取り専用の場合、呼び出しは失敗します。最良のキャプチャ結果を得るには、常に、断片化が解消された、キャプチャデータのサイズよりも大きい、事前に割り当てられたキャプチャファイルにキャプチャしてください。

注意 ICaptureGraphBuilder インターフェイスは非推奨です。代わりに ICaptureGraphBuilder2 を使用してください。事前に割り当てられたキャプチャファイルから有効なメディアデータをコピーします。

HRESULT 値を返します。

新しいファイルには有効なデータのみが含まれるため、コピー元のファイルよりもはるかに小さくできます。通常は、常に同じ巨大な事前割り当て済みファイルにキャプチャし、このメソッドを使用して、各キャプチャから保存したいデータを新しいファイルにコピーします。

pCallback を指定した場合、IAMCopyCaptureFileProgress インターフェイスの Progress メソッドが、完了率を表す 0 から 100 の整数を伴って定期的に呼び出されます。