スマート ティー フィルターの使用
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]
キャプチャ フィルターに個別のキャプチャ ピンとプレビュー ピンがある場合は、もう一方のピンからプレビューしながらキャプチャできます。 ただし、フィルターにプレビュー ピンがない場合は、 グラフに Smart Tee フィルターを含めることで同じことを行うことができます。 このフィルターは、キャプチャ ピンのデータを、キャプチャ用とプレビュー用の 2 つの同一のストリームに分割します。 このプロセスを説明する図を次に示します。
ICaptureGraphBuilder2::RenderStream メソッドは、必要に応じてスマート ティー フィルターを自動的に挿入します。 ただし、 IGraphBuilder メソッドを使用して 、RenderStream ではなくグラフを作成する場合は、Smart Tee フィルターを挿入する必要がある場合があります。
キャプチャ フィルターにピンをレンダリングする前に、フィルターにプレビュー ピンかビデオ ポート ピンかをチェックします。 表示されず、プレビューする場合は、グラフに Smart Tee フィルターを追加し、キャプチャ フィルターのキャプチャ ピンに接続します。
注意
ビデオ ポート (VP) ピンは一種のプレビュー ピンとして扱うことができるため、VP ピンを含むフィルターにはスマート ティー フィルターは必要ありません。 ただし、VP ピンには、他のいくつかの特別な要件があります。 詳細については、「 ビデオ ポート ピン」を参照してください。
関連トピック