Interfaccia IOverlay (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 IOverlay fornisce informazioni in modo che un filtro possa scrivere direttamente nella memoria video durante l'inserimento del video nella posizione corretta della finestra. Viene implementato sul pin di input del renderer video e comunica con un filtro upstream (in genere un decompressor video) chiamando i metodi IOverlayNotify del filtro per notificarlo alle modifiche apportate alla finestra video.

Questa interfaccia non ha alcuna relazione con la funzionalità di sovrapposizione DirectDraw®. Il renderer video Microsoft disegna i dati ricevuti tramite l'interfaccia IMemInputPin , usando sovrimpressione DirectDraw quando disponibile. Questa interfaccia, usata al posto di IMemInputPin, è destinata a fornire supporto per la notifica per qualsiasi filtro upstream che ignora le funzionalità di disegno del renderer, ma richiede notifiche di altre proprietà di visualizzazione.

Per altre informazioni sul funzionamento delle IOverlay interfacce EOverlayNotify, vedere la pagina di riferimento IOverlayNotify.

Per altre informazioni sulle notifiche asincrone delle modifiche alla finestra di rendering, vedere l'interfaccia IOverlayNotify2 .

Questa interfaccia viene implementata nel filtro del renderer video Microsoft® DirectShow®. Può anche essere implementato nei filtri del renderer video sostitutivi se desiderato. In tal caso, implementare questa interfaccia in modo che filtri la scrittura direttamente nel buffer dei fotogrammi o il tentativo di posizionare una sovrimpressione sapere dove visualizzare il video. Per implementare questa interfaccia, il renderer deve essere preparato per usare i metodi nell'interfaccia IOverlayNotify o nell'interfaccia IOverlayNotify2 del filtro che esegue il disegno, con notifiche delle modifiche delle proprietà video.

Il renderer basato su finestre in DirectShow supporta entrambe le interfacce IMemInputPin e IOverlay . Queste due interfacce si escludono a vicenda. Un filtro sceglie di usare il trasporto IOverlay fornendo un tipo di supporto durante la connessione con un sottotipo di MEDIASUBTYPE_Overlay. Dopo la connessione, sarà possibile ottenere e usare correttamente l'interfaccia IOverlay . Se si connette con altri formati video (ad esempio MEDIASUBTYPE_RGB8), provando a chiamare tramite IOverlay restituisce VFW_E_NOT_OVERLAY_CONNECTION.

Usare i metodi in questa funzione da un filtro upstream che deve controllare le proprietà di sovrapposizione video e intende gestire la visualizzazione dei dati video stessi. Questo in genere viene usato dai decodificatori video hardware che dispongono di una connessione alternativa all'hardware video.

Ereditarietà

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

Metodi

L'interfaccia IOverlay include questi metodi.

IOverlay::Consigli Il metodo Advise configura un collegamento consigliato per gli eventi di sovrapposizione specificati dal parametro dwInterests.
IOverlay::GetClipList Il metodo GetClipList recupera l'elenco di ritaglio.
IOverlay::GetColorKey Il metodo GetColorKey recupera la chiave di colore corrente usata per la chiave di cromatura.
IOverlay::GetDefaultColorKey Il metodo GetDefaultColorKey recupera la chiave di colore predefinita usata per una sovrapposizione di chiavi chroma.
IOverlay::GetPalette Il metodo GetPalette recupera la tavolozza di sistema corrente.
IOverlay::GetVideoPosition Il metodo GetVideoPosition recupera i rettangoli di origine video e di destinazione correnti.
IOverlay::GetWindowHandle Il metodo GetWindowHandle recupera l'handle della finestra corrente.
IOverlay::SetColorKey Il metodo SetColorKey modifica la chiave di colore.
IOverlay::SetPalette Il metodo SetPalette imposta la tavolozza.
IOverlay::Unadvise Il metodo Unadvise termina il collegamento consigliato stabilito con l'interfaccia IOverlayNotify.

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)