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 |
|
Bibliothek |
|