ストリーム コントロール
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
VMR の入力ピンの IVMRVideoStreamControl インターフェイスを使用すると、アプリケーションとアップストリーム フィルターで、Z オーダーや VMR の入力ストリームのアクティブな状態など、ミキサー コンポーネントの動作を制御できます。 このインターフェイスはピンで公開されますが、VMR のミキサー コンポーネントで動作するため、ミキサーが読み込まれたときにのみ使用できます。これは、VMR が複数の入力ストリームを処理している場合です。 アップストリーム フィルターでは、 SetColorKey メソッドと GetColorKey メソッドを使用してソース カラー キーを制御します。 これらのメソッドを使用すると、ビデオ上のアニメーションのオーバーレイなどの効果が有効になります。 カラー キーをアニメーション ストリームの背景色に設定するだけで、VMR はそのストリームを別のビデオ ストリームと混在させます。 アプリケーションでは、デコーダーなどのアップストリーム フィルターで使用されている値とは異なる値にカラー キーを変更しないように注意する必要があります。
フィルターでは 、GetStreamActiveState メソッドと SetStreamActiveState メソッドを使用して、指定したピンからの入力データが必要かどうかをミキサーに通知します。 たとえば、Line21 デコーダーは、これらのメソッドを使用して、そのデータがストリームに存在する場合にのみ、Line21 データの VMR の入力ピンをアクティブにします。 ピンを非アクティブ状態に設定すると、イメージを合成する前に、指定したピンからのデータを待機しないようにミキサーに指示されます。