IMemInputPin

IMemInputPin インターフェイスは、メディアデータを入力ピンに配信します。

GetAllocator メソッドは、このピンが提案するメモリアロケーターを取得します。アロケーターが選択された後は、このメソッドは選択されたアロケーターへのポインターを返します。

HRESULT 値を返します。取り得る値には、次の表に示すものが含まれます。

出力ピンが入力ピンに接続する際、メモリアロケーターを決定するために入力ピンと交渉を行います。出力ピンは、入力ピンが提案するアロケーターを取得するためにこのメソッドを呼び出します。そして、選択したアロケーターを指定するために IMemInputPin::NotifyAllocator メソッドを呼び出します。

このメソッドが成功すると、IMemAllocator インターフェイスには未解放の参照カウントが残ります。使い終わったら必ず解放してください。

NotifyAllocator メソッドは、接続に使用するアロケーターを指定します。

成功した場合は S_OK を返し、失敗した場合はエラーの原因を示す HRESULT 値を返します。

ピンの接続時に、出力ピンはアロケーターを選択し、このメソッドを呼び出して入力ピンに通知します。出力ピンは、入力ピンが IMemInputPin::GetAllocator メソッドで提案したアロケーターを使用する場合もあれば、独自のアロケーターを提供する場合もあります。

bReadOnly パラメーターが TRUE の場合、アロケーター内のすべてのサンプルは読み取り専用です。フィルターがデータを変更するには、それらをコピーする必要があります。

GetAllocatorRequirements メソッドは、入力ピンが要求するアロケーターのプロパティを取得します。

HRESULT 値を返します。取り得る値には、次の表に示すものが含まれます。

出力ピンがメモリアロケーターを初期化する際、入力ピンにバッファーの要件があるかどうかを判断するためにこのメソッドを呼び出すことができます。入力ピンはこのメソッドを実装する必要はありません。フィルターに固有のアライメントやプレフィックスの要件がある場合は、このメソッドを実装するべきです。

Receive メソッドは、ストリーム内の次のメディアサンプルを受け取ります。

HRESULT 値を返します。取り得る値には、次の表に示すものが含まれます。

このメソッドは同期的であり、ブロックする可能性があります。ピンは次のいずれかを行います。

• サンプルを拒否する。
• すぐに戻り、ワーカースレッドでサンプルを処理する。
• 戻る前にサンプルを処理する。

ピンがサンプルの処理にワーカースレッドを使用する場合、そのサンプルに対する参照カウントを保持します。いずれの場合も、出力ピンはこのサンプルを直接再利用することはできません。新しいサンプルを取得するには、IMemAllocator::GetBuffer メソッドを呼び出す必要があります。

このメソッドが S_FALSE またはエラーコードを返した場合、上流のフィルターは、グラフが停止するかフラッシュ操作が完了するまでサンプルの送信を停止するべきです。S_FALSE が返される代表的な理由には、次のものがあります。

• 下流のピンがフラッシュ中である。すなわち、BeginFlush 呼び出しを受け取り、まだ EndFlush 呼び出しを受け取っていない。
• 下流のフィルターがストリームの終端を検出した。(End-of-Stream Notifications を参照してください。)

ReceiveMultiple メソッドは、ストリーム内の複数のサンプルを受け取ります。

HRESULT 値を返します。取り得る値には、次の表に示すものが含まれます。

このメソッドは IMemInputPin::Receive メソッドと同様に動作しますが、サンプルの配列を受け取ります。

ReceiveCanBlock メソッドは、IMemInputPin::Receive メソッドの呼び出しがブロックする可能性があるかどうかを判断します。

HRESULT 値を返します。取り得る値には、次の表に示すものが含まれます。

このメソッドが S_FALSE を返した場合、Receive メソッドの呼び出しはブロックしないことが保証されます。そうでない場合は、ブロックする可能性があります。上流のフィルターは、このメソッドを使用してスレッド戦略を決定できます。Receive の呼び出しがブロックし得る場合、上流のフィルターはデータをバッファリングするワーカースレッドを使用することを選択するかもしれません。