Metodo CBaseAllocator.SetNotify

  • Articolo

[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.

[SetNotify può essere modificato o non disponibile nelle versioni successive.]

Il SetNotify metodo imposta o rimuove un callback nell'allocatore. L'allocatore chiama il metodo di callback ogni volta che viene chiamato il metodo IMemAllocator::ReleaseBuffer dell'allocatore .

Sintassi

HRESULT SetNotify(
   IMemAllocatorNotifyCallbackTemp *pNotify
);

Parametri

pNotify

Puntatore all'interfaccia IMemAllocatorNotifyCallbackTemp che verrà usata per il callback. Il chiamante deve implementare l'interfaccia . Usare il valore NULL per rimuovere il callback.

Valore restituito

Restituisce S_OK.

Commenti

Questo metodo implementa il metodo IMemAllocatorCallbackTemp::SetNotify . L'allocatore non espone l'interfaccia IMemAllocatorCallbackTemp a meno che il flag fEnableReleaseCallback non sia impostato su TRUE nel costruttore CBaseAllocator .

Questo metodo imposta la variabile membro CBaseAllocator::m_pNotify uguale a pNotify e incrementa il conteggio dei riferimenti sull'interfaccia. Se m_pNotify è diverso da NULL, il metodo ReleaseBuffer dell'allocatore chiama IMemAllocatorNotifyCallbackTemp::NotifyRelease. Per informazioni sull'implementazione del callback, vedere la sezione Osservazioni in tale metodo.

Requisiti

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

Vedi anche

Classe CBaseAllocator