IMediaSample インターフェイス (strmif.h)

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

インターフェイスは IMediaSample 、メディア サンプルのプロパティを設定および取得します。 メディア サンプルは、メディア データのブロックを含む COM オブジェクトです。 メディア サンプルでは、フィルター間での共有メモリ バッファーの使用がサポートされています。

通常、アプリケーションはこのインターフェイスでメソッドを呼び出しません。 フィルターでは、このインターフェイスを使用してサンプルのプロパティを設定し、ダウンストリーム フィルターにサンプルを配信します。 ダウンストリーム フィルターでは、 インターフェイスを使用してプロパティを取得し、データを読み取ります。 フィルターは、データをインプレースで変更することも、サンプルをコピーしたり、コピーを変更したり、下流にコピーを渡したりすることもできます。

IMediaSample2 インターフェイスはこのインターフェイスを継承します。

継承

IMediaSample インターフェイスは、IUnknown インターフェイスから継承されます。 IMediaSample には、次の種類のメンバーもあります。

メソッド

IMediaSample インターフェイスには、これらのメソッドがあります。

IMediaSample::GetActualDataLength GetActualDataLength メソッドは、バッファー内の有効なデータの長さを取得します。
IMediaSample::GetMediaTime GetMediaTime メソッドは、このサンプルのメディア時間を取得します。
IMediaSample::GetMediaType GetMediaType メソッドは、メディアの種類が前のサンプルと異なる場合に、メディアの種類を取得します。
IMediaSample::GetPointer GetPointer メソッドは、メディア サンプルのバッファーへの読み取り/書き込みポインターを取得します。
IMediaSample::GetSize GetSize メソッドは、バッファーのサイズを取得します。
IMediaSample::GetTime GetTime メソッドは、このサンプルを開始して終了するストリーム時間を取得します。
IMediaSample::IsDiscontinuity IsDiscontinuity メソッドは、このサンプルがデータ ストリームの中断を表しているかどうかを判断します。
IMediaSample::IsPreroll IsPreroll メソッドは、このサンプルがプリロール サンプルであるかどうかを判断します。 プリロール サンプルを表示しないでください。
IMediaSample::IsSyncPoint IsSyncPoint メソッドは、このサンプルの先頭が同期ポイントであるかどうかを判断します。
IMediaSample::SetActualDataLength SetActualDataLength メソッドは、バッファー内の有効なデータの長さを設定します。
IMediaSample::SetDiscontinuity SetDiscontinuity メソッドは、このサンプルがデータ ストリームの中断を表すかどうかを指定します。
IMediaSample::SetMediaTime SetMediaTime メソッドは、このサンプルのメディア時間を設定します。
IMediaSample::SetMediaType SetMediaType メソッドは、サンプルのメディアの種類を設定します。
IMediaSample::SetPreroll SetPreroll メソッドは、このサンプルがプリロール サンプルかどうかを指定します。
IMediaSample::SetSyncPoint SetSyncPoint メソッドは、このサンプルの先頭が同期ポイントであるかどうかを指定します。
IMediaSample::SetTime SetTime メソッドは、このサンプルを開始して終了するストリーム時間を設定します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	strmif.h (Dshow.h を含む)