IGraphBuilder インターフェイス (strmif.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]
このインターフェイスは、アプリケーションがフィルター グラフを作成できるようにするメソッドを提供します。 フィルター グラフ マネージャーは、このインターフェイスを実装します。
IGraphBuilder インターフェイスは、IFilterGraph インターフェイスから継承されます。 IFilterGraph は、グラフにフィルターを追加したり、2 つのピンを接続したりするなどの基本的な操作を提供します。 IGraphBuilder は 、部分的な情報からグラフを構築するメソッドをさらに追加します。 たとえば、 IGraphBuilder::RenderFile メソッドは、ファイルの名前を指定して、ファイル再生用のグラフを作成します。 IGraphBuilder::Render メソッドは、新しいフィルターをピンに接続することで、出力ピンからデータをレンダリングします。
これらのメソッドを使用して、アプリケーションでグラフ内のすべてのフィルターとピン接続を指定する必要はありません。 代わりに、フィルター グラフ マネージャーは、ユーザーのシステムに登録されているフィルターを選択し、グラフに追加して接続します。 詳細については、「 インテリジェント接続」を参照してください。
継承
IGraphBuilder インターフェイスは IFilterGraph から継承されます。 IGraphBuilder には、次の種類のメンバーもあります。
メソッド
IGraphBuilder インターフェイスには、これらのメソッドがあります。
| IGraphBuilder::Abort Abort メソッドは、現在のタスクをできるだけ早く停止するようにフィルター グラフ マネージャーに要求します。 |
| IGraphBuilder::AddSourceFilter AddSourceFilter メソッドは、指定したファイルのソース フィルターをフィルター グラフに追加します。 |
| IGraphBuilder::Connect Connect メソッドは、必要に応じて中間を使用して 2 つのピンを接続します。 |
| IGraphBuilder::Render Render メソッドは、指定した出力ピンからデータをレンダリングするフィルター グラフを作成します。 |
| IGraphBuilder::RenderFile RenderFile メソッドは、指定したファイルをレンダリングするフィルター グラフを作成します。 (IGraphBuilder.RenderFile) |
| IGraphBuilder::SetLogFile SetLogFile メソッドは、操作を実行しようとしたときに実行されるアクションをログに記録するためのファイルを設定します。 |
| IGraphBuilder::ShouldOperationContinue ShouldOperationContinue メソッドは、現在の操作を続行するかどうかを照会します。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | strmif.h (Dshow.h を含む) |