Metodo CBaseAllocator.ReleaseBuffer
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine 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, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Il ReleaseBuffer metodo restituisce un esempio multimediale all'elenco di esempi multimediali gratuiti. Questo metodo implementa il metodo IMemAllocator::ReleaseBuffer .
Sintassi
HRESULT ReleaseBuffer(
IMediaSample *pSample
);
Parametri
-
pSample
-
Puntatore all'interfaccia IMediaSample dell'oggetto di esempio multimediale.
Valore restituito
Restituisce S_OK.
Commenti
Quando il numero di riferimenti di un esempio multimediale raggiunge zero, l'esempio chiama ReleaseBuffer come parametro. Questo metodo esegue le azioni seguenti.
- Restituisce l'esempio multimediale nell'elenco gratuito (CBaseAllocator::m_lFree).
- Chiama il metodo CBaseAllocator::NotifySample , che rilascia tutti i thread bloccati nelle chiamate al metodo CBaseAllocator::GetBuffer .
- Se il metodo CBaseAllocator::SetNotify è stato chiamato in precedenza, chiama il metodo IMemAllocatorNotifyCallbackTemp::NotifyRelease .
- Quando l'ultimo esempio viene rilasciato, se è presente una chiamata CBaseAllocator::D ecommit , chiama il metodo CBaseAllocator::Free per rilasciare la memoria del buffer. Nella classe base Free è un metodo virtuale puro.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|