Freigeben über


CBaseAllocator.Decommit-Methode

[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 Decommit -Methode deaktiviert die Zuordnung. Diese Methode implementiert die IMemAllocator::D ecommit-Methode .

Syntax

HRESULT Decommit();

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Gibt S_OK zurück.

Bemerkungen

Nachdem diese Methode aufgerufen wurde, schlagen Aufrufe der CBaseAllocator::GetBuffer-Methode fehl. Wenn Die Beispiele veröffentlicht werden, werden sie zur kostenlosen Liste zurückgegeben. Wenn das letzte Beispiel zurückgegeben wird, ruft der Zuweisungsgeber die CBaseAllocator::Free-Methode auf, die den zugewiesenen Arbeitsspeicher freigibt. (In der Basisklasse ist Free eine reine virtuelle Methode.)

Darüber hinaus gibt diese Methode alle Threads frei, die bei GetBuffer-Aufrufen blockiert sind. Die Aufrufe von GetBuffer schlagen fehl.

Anforderungen

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

Siehe auch

CBaseAllocator-Klasse