IAMBufferNegotiation-Schnittstelle (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die IAMBufferNegotiation Schnittstelle fordert die Anzahl von Puffern an, die für einen Filter erstellt werden sollen, und die Größe der einzelnen Puffer. Diese Schnittstelle kann von jedem Pin verfügbar gemacht werden, der eine Verbindung über die IMemInputPin-Pinschnittstelle herstellt, wird aber in der Regel auf den Ausgabepins von Erfassungsfiltern verfügbar gemacht.

Wenn zwei Pins über IMemInputPin eine Verbindung herstellen, stimmen sie einem Zuordnungsobjekt zu, das für die Erstellung von Puffern verantwortlich ist. Normalerweise ist dieser Prozess für die Anwendung transparent, aber in einigen Situationen benötigt die Anwendung mehr Kontrolle. Wenn ein Pin verfügbar macht, kann die Anwendung vorschlagen IAMBufferNegotiation, wie viele Puffer erstellt werden soll, wie groß die Puffer sind und welche anderen Eigenschaften sie haben. Wenn Ihre Anwendung eine Vorschau der aufgezeichneten Audiodaten ausführt, können Sie eine kleinere Puffergröße angeben, um die Wartezeit zu verringern. Telekonferenzanwendungen sollten eine minimale Anzahl von Puffern angeben.

Um diese Schnittstelle zu verwenden, rufen Sie die SuggestAllocatorProperties-Methode auf, bevor die Pins eine Verbindung herstellen. Nachdem die Pins eine Verbindung hergestellt haben, rufen Sie die GetAllocatorProperties-Methode auf, um zu ermitteln, ob die Pin die Anforderung erfüllt hat.

Filterentwickler: Erfassungsfilter sollten diese Schnittstelle nach Möglichkeit immer unterstützen.

Vererbung

Die IAMBufferNegotiation-Schnittstelle erbt von der IUnknown-Schnittstelle . IAMBufferNegotiation verfügt auch über folgende Membertypen:

Methoden

Die IAMBufferNegotiation-Schnittstelle verfügt über diese Methoden.

IAMBufferNegotiation::GetAllocatorProperties Die GetAllocatorProperties-Methode ruft die Zuweisungseigenschaften ab, die der Pin verwendet.
IAMBufferNegotiation::SuggestAllocatorProperties Die SuggestAllocatorProperties-Methode informiert die Pin der bevorzugten Zuordnungseigenschaften der Anwendung. Rufen Sie diese Methode auf, bevor der Pin eine Verbindung herstellt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)

Siehe auch

Schnittstellen