Interfaccia IDistributorNotify (strmif.h)
[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.
L'interfaccia IDistributorNotify consente a un server di distribuzione plug-in di ricevere una notifica quando cambia il grafico del filtro.
Le applicazioni non usano mai questa interfaccia. Implementare questa interfaccia se si scrive un server di distribuzione plug-in (PID) e si vuole che il PID riceva notifiche di controllo e modifiche nella composizione dei grafici di filtro.
La query Filter Graph Manager per questa interfaccia su tutti i distributori plug-in aggregati. Se un PID espone questa interfaccia, Filter Graph Manager notifica il PID di qualsiasi modifica dello stato chiamando i metodi IDistributorNotify prima di chiamare i metodi IBaseFilter equivalenti nei filtri. Filter Graph Manager chiama anche il metodo IDistributorNotify::NotifyGraphChange ogni volta che aggiunge o rimuove un filtro o qualsiasi modifica delle connessioni pin.
Durante una chiamata a qualsiasi metodo IDistributorNotify , non contenere alcuna sezione critica che potrebbe essere contenuta da un altro percorso di codice che chiama i metodi in Filter Graph Manager. In questo modo potrebbe verificarsi un deadlock.
Ereditarietà
L'interfaccia IDistributorNotify eredita dall'interfaccia IUnknown . IDistributorNotify include anche questi tipi di membri:
Metodi
L'interfaccia IDistributorNotify include questi metodi.
| IDistributorNotify::NotifyGraphChange Il metodo NotifyGraphChange viene chiamato quando il set di filtri nel grafico del filtro cambia o qualsiasi modifica delle connessioni pin. |
| IDistributorNotify::P ause Il metodo Pause viene chiamato quando il grafico del filtro immette uno stato sospeso. |
| IDistributorNotify::Run Il metodo Run viene chiamato quando il grafico del filtro immette uno stato in esecuzione. |
| IDistributorNotify::SetSyncSource Il metodo SetSyncSource viene chiamato quando viene registrato un nuovo orologio. |
| IDistributorNotify::Stop Il metodo Stop viene chiamato quando il grafico del filtro immette uno stato arrestato. |
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 | strmif.h (include Dshow.h) |