Interfaccia IMediaEvent (control.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.
L'interfaccia IMediaEvent contiene metodi per recuperare le notifiche degli eventi e per eseguire l'override della gestione predefinita di Eventi di Filter Graph Manager. L'interfaccia IMediaEventEx eredita questa interfaccia e la estende.
Filter Graph Manager implementa questa interfaccia. Le applicazioni possono usarlo per rispondere agli eventi che si verificano nel grafico dei filtri, ad esempio la fine di un flusso o un errore di rendering. Filtra i post-eventi nel grafico dei filtri usando l'interfaccia IMediaEventSink .
Per altre informazioni sulla notifica degli eventi, vedere Notifica eventi in DirectShow. Per un elenco delle notifiche degli eventi definite dal sistema, vedere Codici di notifica degli eventi.
Ereditarietà
L'interfaccia IMediaEvent eredita dall'interfaccia IDispatch . IMediaEvent include anche questi tipi di membri:
Metodi
L'interfaccia IMediaEvent include questi metodi.
| IMediaEvent::CancelDefaultHandling Il metodo CancelDefaultHandling annulla la gestione predefinita di Filter Graph Manager per un evento specificato. La notifica degli eventi viene passata all'applicazione. |
| IMediaEvent::FreeEventParams Il metodo FreeEventParams libera le risorse associate ai parametri di un evento. |
| IMediaEvent::GetEvent Il metodo GetEvent recupera la notifica dell'evento successiva dalla coda di eventi. |
| IMediaEvent::GetEventHandle Il metodo GetEventHandle recupera un handle per un evento di reimpostazione manuale che rimane segnalato mentre la coda contiene le notifiche degli eventi. |
| IMediaEvent::RestoreDefaultHandling Il metodo RestoreDefaultHandling ripristina la gestione predefinita di Filter Graph Manager per un evento specificato. |
| IMediaEvent::WaitForCompletion Il metodo WaitForCompletion attende che il grafico del filtro esegua il rendering di tutti i dati disponibili. Il grafico del filtro deve essere in esecuzione o il metodo ha esito negativo. |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | control.h (include Dshow.h) |