IAMBufferNegotiation インターフェイス (strmif.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]
インターフェイスは IAMBufferNegotiation 、作成するフィルターのバッファー数と各バッファーのサイズを要求します。 このインターフェイスは、 IMemInputPin ピン インターフェイスを使用して接続する任意のピンによって公開できますが、通常はキャプチャ フィルターの出力ピンで公開されます。
2 つのピンが IMemInputPin を介して接続すると、バッファーの作成を担当するアロケーター オブジェクトに同意します。 通常、このプロセスはアプリケーションに対して透過的ですが、状況によっては、アプリケーションでより多くの制御が必要な場合があります。 ピンで が公開されている IAMBufferNegotiation場合、アプリケーションは、作成するバッファーの数、バッファーのサイズ、およびその他のプロパティを提案できます。 キャプチャされたオーディオのプレビューをアプリケーションで実行する場合は、バッファー サイズを小さく指定して待機時間を短縮できます。 電話会議アプリケーションでは、バッファーの最小数を指定する必要があります。
このインターフェイスを使用するには、ピンが接続される前に SuggestAllocatorProperties メソッドを呼び出します。 ピンが接続されたら、 GetAllocatorProperties メソッドを呼び出して、ピンが要求を受け入れたかどうかを判断します。
フィルター開発者: キャプチャ フィルターは、可能な場合は常にこのインターフェイスをサポートする必要があります。
継承
IAMBufferNegotiation インターフェイスは、IUnknown インターフェイスから継承されます。 IAMBufferNegotiation には、次の種類のメンバーもあります。
メソッド
IAMBufferNegotiation インターフェイスには、これらのメソッドがあります。
| IAMBufferNegotiation::GetAllocatorProperties GetAllocatorProperties メソッドは、ピンで使用されているアロケーター プロパティを取得します。 |
| IAMBufferNegotiation::SuggestAllocatorProperties SuggestAllocatorProperties メソッドは、アプリケーションの優先アロケーター プロパティのピンを通知します。 ピンが接続する前に、このメソッドを呼び出します。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | strmif.h (Dshow.h を含む) |