Condividi tramite


Metodo CBaseAllocator.Decommit

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il Decommit metodo decommette l'allocatore. Questo metodo implementa il metodo IMemAllocator::D ecommit .

Sintassi

HRESULT Decommit();

Parametri

Questo metodo non presenta parametri.

Valore restituito

Restituisce S_OK.

Commenti

Dopo la chiamata a questo metodo, le chiamate al metodo CBaseAllocator::GetBuffer avranno esito negativo. Man mano che vengono rilasciati esempi, vengono restituiti all'elenco gratuito. Quando viene restituito l'ultimo esempio, l'allocatore chiama il metodo CBaseAllocator::Free , che rilascia la memoria allocata. Nella classe base Free è un metodo virtuale puro.

Questo metodo rilascia inoltre tutti i thread bloccati nelle chiamate GetBuffer . Le chiamate a GetBuffer hanno esito negativo.

Requisiti

Requisito Valore
Intestazione
Amfilter.h (include Streams.h)
Libreria
Strmbase.lib (build retail);
Strmbasd.lib (build di debug)

Vedi anche

Classe CBaseAllocator