CBaseAllocator.ReleaseBuffer-Methode

Artikel
07/28/2023

[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 ReleaseBuffer -Methode gibt ein Medienbeispiel in die Liste der kostenlosen Medienbeispiele zurück. Diese Methode implementiert die IMemAllocator::ReleaseBuffer-Methode .

Syntax

HRESULT ReleaseBuffer(
   IMediaSample *pSample
);

Parameter

pSample: Zeiger auf die IMediaSample-Schnittstelle des Medienbeispielobjekts.

Rückgabewert

Gibt S_OK zurück.

Bemerkungen

Wenn die Referenzanzahl eines Medienbeispiels null erreicht, ruft das Beispiel ReleaseBuffer mit sich selbst als Parameter auf. Diese Methode führt die folgenden Aktionen aus.

Gibt das Medienbeispiel in die kostenlose Liste zurück (CBaseAllocator::m_lFree).
Ruft die CBaseAllocator::NotifySample-Methode auf, die alle Threads freigibt, die bei Aufrufen der CBaseAllocator::GetBuffer-Methode blockiert werden.
Wenn die CBaseAllocator::SetNotify-Methode zuvor aufgerufen wurde, ruft die IMemAllocatorNotifyCallbackTemp::NotifyRelease-Methode auf.
Wenn das letzte Beispiel veröffentlicht wird und ein CBaseAllocator::D ecommit-Aufruf aussteht, ruft die CBaseAllocator::Free-Methode auf, um den Pufferspeicher freizugeben. (In der Basisklasse ist Free eine reine virtuelle Methode.)

Anforderungen

Anforderung	Wert
Header	Amfilter.h (include Streams.h)
Bibliothek	Strmbase.lib (Einzelhandelsbuilds); Strmbasd.lib (Debugbuilds)

Siehe auch

CBaseAllocator-Klasse

Freigeben über