Interfaccia IOverlayNotify (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.

L'interfaccia IOverlayNotify fornisce un filtro upstream, ad esempio un decodificatore, con notifiche delle modifiche apportate alla finestra di rendering. Sono incluse le notifiche delle modifiche apportate alla tavolozza, alla chiave di colore e alla posizione della finestra e alle modifiche dell'area visibile (ritaglio).

La maggior parte dei decodificatori video software consente al renderer di disegnare le immagini decompresse prodotte passando gli esempi multimediali all'interfaccia IMemInputPin sul pin di input del renderer.

Tuttavia, alcuni filtri di decodifica video (in genere schede di decompressione hardware) gestiscono il disegno delle immagini stesse, forse usando un connettore VGA. Questi filtri non devono usare IMemInputPin, ma possono usare l'interfaccia IOverlay fornita dal pin di input del renderer. Tramite questa interfaccia, il decodificatore può ricevere una notifica quando cambia la posizione o le dimensioni della finestra o quando cambia la tavolozza di sistema corrente per installare e modificare i tasti colore e le tavolozze.

I decodificatori che eseguono il proprio disegno devono implementare le IOverlayNotify interfacce e IOverlayNotify2 . Il renderer usa questa interfaccia per notificare al decodificatore ogni volta che cambiano le dimensioni o la posizione della finestra, la tavolozza di sistema cambia o viene usata una chiave di colore diversa. Il decodificatore deve chiamare il metodo IOverlay::Advise sul pin di input del renderer, per configurare il callback. Dopo aver stabilito il callback, il renderer chiama i metodi del IOverlayNotify decodificatore quando si verificano gli eventi appropriati. Per annullare il callback, utilizzare il metodo IOverlay::Unadvise .

Il renderer video è l'unico filtro che chiama i metodi in questa interfaccia. Questa operazione viene eseguita automaticamente dal renderer video predefinito. Se si sta scrivendo un renderer video sostitutivo, sarà necessario usare i metodi in questa interfaccia se il filtro supporta IOverlay e questa interfaccia viene passata al filtro in una chiamata IOverlay::Advise .

Ereditarietà

L'interfaccia IOverlayNotify eredita dall'interfaccia IUnknown . IOverlayNotify include anche questi tipi di membri:

Metodi

L'interfaccia IOverlayNotify include questi metodi.

IOverlayNotify::OnClipChange Il metodo OnClipChange fornisce una notifica che indica che l'area visibile della finestra è stata modificata. È essenziale che qualsiasi hardware di sovrimpressione venga aggiornato in modo da riflettere la modifica all'area visibile prima di restituire da questo metodo.
IOverlayNotify::OnColorKeyChange Il metodo OnColorKeyChange fornisce una notifica che indica che la chiave di colore della finestra è stata modificata.
IOverlayNotify::OnPaletteChange Il metodo OnPaletteChange fornisce una notifica che indica che la tavolozza della finestra è stata modificata.
IOverlayNotify::OnPositionChange Il metodo OnPositionChange fornisce una notifica che indica che la posizione è stata modificata.

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)