次の方法で共有

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 を含む)

関連項目

インターフェイス