Panoramica della notifica degli eventi

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

Un filtro notifica a Filter Graph Manager informazioni su un evento pubblicando una notifica degli eventi. L'evento potrebbe essere previsto, ad esempio la fine di un flusso, o potrebbe rappresentare un errore, ad esempio un errore durante il rendering di un flusso. Filter Graph Manager gestisce alcuni eventi di filtro autonomamente e ne lascia altri per l'applicazione da gestire. Se Filter Graph Manager non gestisce un evento di filtro, inserisce la notifica degli eventi in una coda. Il grafico dei filtri può anche accodarne le notifiche degli eventi per l'applicazione.

Un'applicazione recupera gli eventi dalla coda e risponde in base al tipo di evento. La notifica degli eventi in DirectShow è quindi simile allo schema di accodamento messaggi di Microsoft Windows. Un'applicazione può anche annullare il comportamento predefinito di Filter Graph Manager per un determinato tipo di evento. Filter Graph Manager inserisce quindi tali eventi direttamente nella coda per l'applicazione da gestire.

Questo meccanismo abilita

  • Filter Graph Manager per comunicare con l'applicazione.
  • Filtra per comunicare sia con l'applicazione che con Filter Graph Manager.
  • Applicazione per determinare il grado di coinvolgimento nella gestione degli eventi.