次の方法で共有

メディア サンプルとアロケーターについて

  • [アーティクル]

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

フィルターは、ピン接続間でデータを配信します。 データは、あるフィルターの出力ピンから別のフィルターの入力ピンに移動します。 出力ピンでデータを配信する最も一般的な方法は、入力で IMemInputPin::Receive メソッドを呼び出すことですが、他にもいくつかのメカニズムが存在します。

フィルターに応じて、メディア データのメモリは、ヒープ、DirectDraw サーフェイス、共有 GDI メモリの使用、またはその他の割り当てメカニズムの使用など、さまざまな方法で割り当てることができます。 メモリの割り当てを担当するオブジェクトは、 アロケーターと呼ばれます。これは、 IMemAllocator インターフェイスを公開する COM オブジェクトです。

2 つのピンが接続されている場合、ピンの 1 つがアロケーターを提供する必要があります。 DirectShow は、アロケーターを提供するピンを確立するために使用されるメソッド呼び出しのシーケンスを定義します。 ピンは、アロケーターが作成するバッファーの数とバッファーのサイズについても一致します。

ストリーミングが開始される前に、アロケーターによってバッファーのプールが作成されます。 ストリーミング中、アップストリーム フィルターはバッファーにデータを入力し、ダウンストリーム フィルターに配信します。 ただし、アップストリーム フィルターは、ダウンストリーム フィルターにバッファーへの未加工のポインターを与えません。 代わりに、 メディア サンプルと呼ばれる COM オブジェクトを使用します。このオブジェクトは、アロケーターがバッファーを管理するために作成します。 メディア サンプルは 、IMediaSample インターフェイスを公開します。 メディア サンプルには、次のものが含まれます。

  • 基になるバッファーへのポインター
  • タイム スタンプ
  • さまざまなフラグ
  • 必要に応じて、メディアの種類

タイム スタンプは、レンダリングのスケジュールにレンダラー フィルターが使用するプレゼンテーション時間を定義します。 フラグは、前のサンプル以降にデータに中断があったかどうかを示します。 メディアの種類は、フィルターがストリームの途中で形式を変更する方法を提供します。 通常、サンプルにはメディアの種類がありません。これは、前のサンプル以降に形式が変更されていないことを示します。

フィルターはバッファーを使用している間、サンプルの参照カウントを保持します。 アロケーターは、参照カウントを使用して、バッファーを再利用できるタイミングを決定します。 これにより、別のフィルターでまだ使用されているバッファーがフィルターによって上書きされるのを防ぐことができます。 サンプルは、すべてのフィルターによって解放されるまで、アロケーターの使用可能なサンプルのプールに戻りません。

詳細については、次のトピックを参照してください。

次のトピックは、独自のカスタム フィルターを記述する開発者を対象としています。

フィルター グラフとそのコンポーネント