Metodo IVMRSurfaceAllocatorNotify::NotifyEvent (strmif.h)
[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 NotifyEvent
metodo viene chiamato dal relatore allocatore per informare il VMR di eventuali eventi DirectShow significativi durante i processi di allocazione o presentazione.
Sintassi
HRESULT NotifyEvent(
[in] LONG EventCode,
[in] LONG_PTR Param1,
[in] LONG_PTR Param2
);
Parametri
[in] EventCode
Specifica il codice dell'evento.
[in] Param1
Specifica Param1 del codice evento.
[in] Param2
Specifica Param2 del codice evento.
Valore restituito
Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, viene restituito un codice di errore.
Commenti
VmR fornisce all'allocatore-relatore un puntatore a questa interfaccia in una chiamata a IVMRSurfaceAllocator::AdviseNotify. Quando allocator-relatore chiama questo metodo e specifica un normale evento DirectShow, ad esempio EC_ERRORABORT o EC_VMR_RENDERDEVICE_SET, vmR passerà l'evento al gestore del grafo del filtro.
Requisiti
Client minimo supportato | Windows XP con SP1 [solo app desktop] |
Server minimo supportato | Windows Server 2003 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | strmif.h (include Dshow.h) |
Libreria | Strmiids.lib |