ICaptureGraphBuilder2 インターフェイス (strmif.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
インターフェイスは ICaptureGraphBuilder2 、キャプチャ グラフとその他のカスタム フィルター グラフを構築します。 Capture Graph Builder オブジェクトは、このインターフェイスを実装します。
メモ 既定では、
ICaptureGraphBuilder2 インターフェイスは Video Mixing Renderer (VMR)、Enhanced Video Renderer (EVR) または Video Port Manager フィルターを使用しません。継承
ICaptureGraphBuilder2 インターフェイスは、IUnknown インターフェイスから継承します。 ICaptureGraphBuilder2 には、次の種類のメンバーもあります。
メソッド
ICaptureGraphBuilder2 インターフェイスには、これらのメソッドがあります。
| ICaptureGraphBuilder2::AllocCapFile AllocCapFile メソッドは、キャプチャ ファイルを指定したサイズに事前割り当てします。 最適な結果を得るには、常に、キャプチャ データのサイズよりも大きい最適化された事前割り当て済みキャプチャ ファイルにキャプチャします。 |
| ICaptureGraphBuilder2::ControlStream ControlStream メソッドは、キャプチャされたデータの 1 つ以上のストリームの開始時刻と停止時刻を設定します。 |
| ICaptureGraphBuilder2::CopyCaptureFile CopyCaptureFile メソッドは、キャプチャ ファイルから有効なメディア データをコピーします。 |
| ICaptureGraphBuilder2::FindInterface FindInterface メソッドは、指定したフィルターから開始して、指定したインターフェイスをグラフで検索します。 |
| ICaptureGraphBuilder2::FindPin FindPin メソッドは、フィルター上の特定のピンを取得するか、指定されたピンが指定された条件と一致するかどうかを判断します。 |
| ICaptureGraphBuilder2::GetFiltergraph GetFiltergraph メソッドは、キャプチャ グラフ ビルダーが使用しているフィルター グラフを取得します。 |
| ICaptureGraphBuilder2::RenderStream RenderStream メソッドは、ソース フィルターの出力ピンを、必要に応じて中間フィルターを介してシンク フィルターに接続します。 |
| ICaptureGraphBuilder2::SetFiltergraph SetFiltergraph メソッドは、キャプチャ グラフ ビルダーが使用するフィルター グラフを指定します。 |
| ICaptureGraphBuilder2::SetOutputFileName SetOutputFileName メソッドは、フィルター グラフのファイル書き込みセクションを作成します。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | strmif.h (Dshow.h を含む) |