IMFSample インターフェイス (mfobjects.h)

メディア データのコンテナー オブジェクトであるメディア サンプルを表します。 ビデオの場合、サンプルには通常、1 つのビデオ フレームが含まれます。 オーディオ データの場合、サンプルには通常、オーディオの 1 つのサンプルではなく、複数のオーディオ サンプルが含まれます。

メディア サンプルには、0 個以上のバッファーが含まれています。 各バッファーはメモリ ブロックを管理し、 IMFMediaBuffer インターフェイスによって表されます。 サンプルには複数のバッファーを含めることができます。 バッファーは順序付きリストに保持され、インデックス値によってアクセスされます。 バッファーのない空のサンプルを持つことも有効です。

継承

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

メソッド

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

IMFSample::AddBuffer サンプル内のバッファーの一覧の末尾にバッファーを追加します。
IMFSample::ConvertToContiguousBuffer 複数のバッファーを持つサンプルを、1 つのバッファーを持つサンプルに変換します。
IMFSample::CopyToBuffer サンプル データをバッファーにコピーします。 このメソッドは、サンプルのすべてのバッファーから有効なデータを順番に連結します。
IMFSample::GetBufferByIndex インデックスを使用して、サンプルからバッファーを取得します。
IMFSample::GetBufferCount サンプル内のバッファーの数を取得します。
IMFSample::GetSampleDuration サンプルの期間を取得します。
IMFSample::GetSampleFlags サンプルに関連付けられているフラグを取得します。現在、フラグは定義されていません。
IMFSample::GetSampleTime サンプルのプレゼンテーション時間を取得します。
IMFSample::GetTotalLength サンプル内のすべてのバッファー内の有効なデータの合計長を取得します。 長さは、IMFMediaBuffer::GetCurrentLength メソッドによって取得された値の合計として計算されます。
IMFSample::RemoveAllBuffers サンプルからすべてのバッファーを削除します。
IMFSample::RemoveBufferByIndex 指定したインデックス位置にあるバッファーをサンプルから削除します。
IMFSample::SetSampleDuration サンプルの期間を設定します。
IMFSample::SetSampleFlags サンプルに関連付けられているフラグを設定します。現在、フラグは定義されていません。
IMFSample::SetSampleTime サンプルの表示時間を設定します。

注釈

新しいメディア サンプルを作成するには、 MFCreateSample を呼び出します。

注  

IMFSample で IMFAttributes インターフェイスから継承された CopyAllItems を呼び出すと、サンプルの時刻、期間、フラグはコピー先のサンプルにコピーされません。 これらの値は、手動で新しいサンプルにコピーする必要があります。

 

このインターフェイスは、Windows Media Format 11 SDK 再頒布可能コンポーネントがインストールされている場合、次のプラットフォームで使用できます。

• Windows XP Service Pack 2 (SP2) 以降。
• Windows XP Media Center Edition 2005 KB900325 (Windows XP Media Center Edition 2005) とKB925766 (2006 年 10 月 Windows XP Media Center Edition の更新プログラムのロールアップ) がインストールされています。

要件

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

こちらもご覧ください

IMFAttributes

メディア ファンデーション インターフェイス

メディア サンプル

サンプル属性