Interfaccia IVideoWindow (control.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 IVideoWindow imposta le proprietà nella finestra video. Le applicazioni possono usarle per impostare il proprietario della finestra, la posizione e le dimensioni della finestra e altre proprietà.

Nota L'interfaccia IVMRWindowlessControl o IVMRWindowlessControl9 è ora preferita rispetto IVideoWindowa . Per altre informazioni, vedere Uso della modalità senza finestra.
 
Il filtro Del renderer video e Il gestore di filtri espongono entrambe questa interfaccia. Filter Graph Manager inoltra tutte le chiamate di metodo a Video Renderer. Inoltra anche determinati messaggi di finestra che il Renderer video deve ricevere, ad esempio WM_DISPLAYCHANGE. Poiché la finestra video è in genere un elemento figlio di una finestra dell'applicazione, il filtro non riceverà in caso contrario questi messaggi. Pertanto si basa su Filter Graph Manager per inoltrarli.

Nella maggior parte dei casi, un'applicazione deve eseguire una query su Filter Graph Manager per questa interfaccia e non chiamare direttamente il filtro, a causa del problema di messaggistica appena descritto. Tuttavia, se il grafico del filtro ha più di un renderer video, Filter Graph Manager comunica solo con uno di essi, selezionato arbitrariamente. Pertanto, se l'applicazione usa più finestre video, usare l'interfaccia IVideoWindow direttamente nei filtri. In tal caso, è necessario inoltrare i messaggi della finestra a ogni istanza di Video Renderer usando il metodo IVideoWindow::NotifyOwnerMessage .

Per evitare che la finestra video venga sfarfallata durante le repaint, eseguire l'override della gestione predefinita per il messaggio WM_ERASEBKGND e non cancellare la finestra. Per le applicazioni MFC, eseguire l'override di CWnd::OnEraseBkgnd con un gestore vuoto.

Le proprietà impostate su un renderer video persistono tra connessioni successive e disconnessioni.

Poiché questa interfaccia è compatibile con l'automazione, tutti i valori booleani vengono definiti come OAFALSE (0) e OATRUE (–1).

Codici di errore: Se il filtro del renderer video non è connesso a un altro filtro, tutti i metodi restituiscono il codice di errore VFW_E_NOT_CONNECTED. Per l'implementazione di Filter Graph Manager, se il grafico non contiene un filtro del renderer video, tutti i metodi restituiscono E_NOINTERFACE. Si noti che Filter Graph Manager espone l'interfaccia anche quando il grafico non contiene un renderer video, in modo che un'applicazione possa eseguire query per l'interfaccia prima di compilare il grafico.

Filtrare gli sviluppatori: È possibile usare la classe CBaseVideoWindow per implementare questa interfaccia.

Ereditarietà

L'interfaccia IVideoWindow eredita dall'interfaccia IDispatch . IVideoWindow include anche questi tipi di membri:

Metodi

L'interfaccia IVideoWindow include questi metodi.

 
IVideoWindow::get_AutoShow

Il metodo get_AutoShow esegue una query se il renderer video visualizza automaticamente la finestra video quando riceve i dati video.
IVideoWindow::get_BackgroundPalette

Il metodo get_BackgroundPalette esegue una query sul fatto che la finestra video si renda conto della relativa tavolozza in background.
IVideoWindow::get_BorderColor

Il metodo get_BorderColor recupera il colore visualizzato intorno ai bordi del rettangolo di destinazione.
IVideoWindow::get_Caption

Il metodo get_Caption recupera la finestra video didascalia.
IVideoWindow::get_FullScreenMode

Il metodo get_FullScreenMode esegue una query se il renderer video è in modalità schermo intero.
IVideoWindow::get_Height

Il metodo get_Height recupera l'altezza della finestra video.
IVideoWindow::get_Left

Il metodo get_Left recupera la coordinata dell'asse x della finestra video.
IVideoWindow::get_MessageDrain

Il metodo get_MessageDrain recupera la finestra che riceve i messaggi del mouse e della tastiera dalla finestra video, se presente.
IVideoWindow::get_Owner

Il metodo get_Owner recupera la finestra padre della finestra del video, se presente.
IVideoWindow::get_Top

Il metodo get_Top recupera la coordinata y della finestra video.
IVideoWindow::get_Visible

Il metodo get_Visible esegue una query sul fatto che la finestra video sia visibile.
IVideoWindow::get_Width

Il metodo get_Width recupera la larghezza della finestra video.
IVideoWindow::get_WindowState

Il metodo get_WindowState esegue una query sul fatto che la finestra video sia visibile, nascosta, ridotta al minimo o ingrandita.
IVideoWindow::get_WindowStyle

Il metodo get_WindowStyle recupera gli stili della finestra nella finestra video.
IVideoWindow::get_WindowStyleEx

Il metodo get_WindowStyleEx recupera gli stili di finestra estesi nella finestra video.
IVideoWindow::GetMaxIdealImageSize

Il metodo GetMaxIdealImageSize recupera le dimensioni massime dell'immagine ideale per l'immagine video.
IVideoWindow::GetMinIdealImageSize

Il metodo GetMinIdealImageSize recupera le dimensioni minime ideali per l'immagine video.
IVideoWindow::GetRestorePosition

Il metodo GetRestorePosition recupera la posizione della finestra ripristinata.
IVideoWindow::GetWindowPosition

Il metodo GetWindowPosition recupera la posizione della finestra video.
IVideoWindow::HideCursor

Il metodo HideCursor mostra o nasconde il cursore quando il mouse viene posizionato sulla finestra video.
IVideoWindow::IsCursorHidden

Il metodo IsCursorHidden esegue una query sul fatto che il cursore sia nascosto.
IVideoWindow::NotifyOwnerMessage

Il metodo NotifyOwnerMessage inoltra un messaggio alla finestra video.
IVideoWindow::p ut_AutoShow

Il metodo put_AutoShow specifica se il renderer video visualizza automaticamente la finestra video quando riceve dati video.
IVideoWindow::p ut_BackgroundPalette

Il metodo put_BackgroundPalette specifica se la finestra video realizza la relativa tavolozza in background.
IVideoWindow::p ut_BorderColor

Il metodo put_BorderColor imposta il colore visualizzato intorno ai bordi del rettangolo di destinazione.
IVideoWindow::p ut_Caption

Il metodo put_Caption imposta la finestra video didascalia.
IVideoWindow::p ut_FullScreenMode

Il metodo put_FullScreenMode abilita o disabilita il rendering video a schermo intero.
IVideoWindow::p ut_Height

Il metodo put_Height imposta l'altezza della finestra video.
IVideoWindow::p ut_Left

Il metodo put_Left imposta la coordinata x della finestra video.
IVideoWindow::p ut_MessageDrain

Il metodo put_MessageDrain specifica una finestra per ricevere messaggi da mouse e tastiera dalla finestra video.
IVideoWindow::p ut_Owner

Il metodo put_Owner specifica una finestra padre per la finestra video.
IVideoWindow::p ut_Top

Il metodo put_Top specifica la coordinata y della finestra video.
IVideoWindow::p ut_Visible

Il metodo put_Visible mostra o nasconde la finestra video.
IVideoWindow::p ut_Width

Il metodo put_Width specifica la larghezza della finestra video.
IVideoWindow::p ut_WindowState

Il metodo put_WindowState mostra, nasconde, riduce al minimo o ottimizza la finestra video.
IVideoWindow::p ut_WindowStyle

Il metodo put_WindowStyle imposta gli stili della finestra nella finestra video.
IVideoWindow::p ut_WindowStyleEx

Il metodo put_WindowStyleEx imposta gli stili di finestra estesi nella finestra video.
IVideoWindow::SetWindowForeground

Il metodo SetWindowForeground posiziona la finestra video nella parte superiore dell'ordine Z.
IVideoWindow::SetWindowPosition

Il metodo SetWindowPosition imposta la posizione della finestra video.

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 (includere Dshow.h)

Vedi anche

Idispatch