IMFSampleOutputStream

メディアサンプルをバイトストリームに書き込みます。

書き込み可能なバイトストリームは、必要に応じてこのインターフェイスを実装できます。

このインターフェイスを使用すると、呼び出し元は、型情報を持たないデータのブロブを書き込む IMFByteStream::BeginWrite メソッドを使用する代わりに、メディアサンプルをバイトストリームに送信して書き込むことができます。バイトストリームは、メディアサンプルに含まれる情報を利用して、データの書き込み方法を最適化できます。たとえば、ネットワーク経由でメディアデータを送信するバイトストリームは、タイムスタンプに基づいて最適化を行えます。

このインターフェイスへのポインターを取得するには、バイトストリームオブジェクトに対して QueryInterface を呼び出します。

IMFSampleOutputStream をインターフェイスとして公開する IMFByteStream の実装は、次の要件を満たす必要があります。

• いずれのインターフェイスからの書き込みも、常にまったく同一のバイトストリームオブジェクトに対して行われます。
• IMFSampleOutputStream と IMFByteStream の現在位置は、常に同一でなければなりません。たとえば、IMFSampleOutputStream への書き込みは、IMFByteStream の現在位置も更新します。
• BeginWriteSample と EndWriteSample を使用したサンプルの書き込みは、サンプル内のすべてのバッファーのデータを、それらがサンプルに格納されている順序で書き込むことによってサンプルをシリアル化しなければなりません。 (インデックス値によって個々のバッファーを取得するには、IMFSample::GetBufferByIndex を使用します。) コピーされる合計バイト数は、すべてのバッファーから書き込まれたバイト数となります。

メディアサンプルをストリームに書き込む非同期要求を開始します。

このメソッドが成功した場合、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

サンプルがストリームに書き込まれると、コールバックオブジェクトの IMFAsyncCallback::Invoke メソッドが呼び出されます。その時点で、呼び出し元は IMFSampleOutputStream::EndWriteSample を呼び出して非同期要求を完了する必要があります。

メディアサンプルをストリームに書き込む非同期要求を完了します。

このメソッドが成功した場合、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

このメソッドは、IMFSampleOutputStream::BeginWriteSample メソッドが非同期に完了したときに呼び出します。