IFileSinkFilter2 インターフェイス (strmif.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]
IFileSinkFilter2 インターフェイスは、IFileSinkFilter インターフェイスを拡張します。 ファイルにメディア ストリームを書き込むフィルターは、このインターフェイスを実装します。 たとえば、ビデオ キャプチャ フィルター グラフのファイル シンク フィルターは、ビデオ圧縮フィルターの出力をファイルに保存します。 通常、このフィルター グラフを実行しているアプリケーションでは、データを保存するファイルの名前をユーザーが入力できるようにする必要があります。 このインターフェイスを使用すると、この情報を通信できます。
IFileSinkFilter2 では、書き込むファイルが同じ名前の既存のファイルを破棄するかどうかを判断するオプションが追加されます。 ビデオ キャプチャの場合は、既に作成したファイルを破棄しないでください。これは、ファイル領域の事前割り当てには貴重な時間がかかるためです。 既定では、新しいファイルは古いファイルを破棄しません。 それ以外の場合は、元のファイルを破棄して、作成したファイルにガベージが含まれていないことを確認します。
継承
IFileSinkFilter2 インターフェイスは、IFileSinkFilter から継承されます。 IFileSinkFilter2 には、次の種類のメンバーもあります。
メソッド
IFileSinkFilter2 インターフェイスには、これらのメソッドがあります。
| IFileSinkFilter2::GetMode GetMode メソッドは、ファイル ライターが新しいファイルを作成するときにファイルを破棄するかどうかを取得します。 |
| IFileSinkFilter2::SetMode SetMode メソッドは、ファイル ライターが新しいファイルを作成するときにファイルを破棄するかどうかを決定します。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | strmif.h (Dshow.h を含む) |