comando MCI_WINDOW
Il comando MCI_WINDOW specifica la finestra e le caratteristiche della finestra per i dispositivi grafici. I dispositivi di sovrimpressione digitale e video riconoscono questo comando.
Per inviare questo comando, chiamare la funzione mciSendCommand con i parametri seguenti.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_WINDOW,
DWORD dwFlags,
(DWORD) (LPMCI_GENERIC_PARMS) lpWindow
);
Parametri
-
wDeviceID
-
Identificatore del dispositivo MCI che deve ricevere il messaggio di comando.
-
Dwflags
-
MCI_NOTIFY, MCI_WAIT o, per dispositivi video digitali, MCI_TEST. Per informazioni su questi flag, vedere Il flag Wait, Notify e Test Flag.
-
lpWindow
-
Puntatore a una struttura MCI_GENERIC_PARMS . I dispositivi con set di comandi estesi potrebbero sostituire questa struttura con una struttura specifica del dispositivo.
Valore restituito
Restituisce zero se ha esito positivo o un errore in caso contrario.
Commenti
I dispositivi grafici devono creare una finestra predefinita quando un dispositivo viene aperto, ma non dovrebbe visualizzarlo finché non ricevono il comando MCI_PLAY . Il comando MCI_WINDOW viene usato per fornire una finestra creata dall'applicazione al dispositivo e modificare le caratteristiche di visualizzazione di una finestra di visualizzazione definita dall'applicazione o predefinita. Se l'applicazione fornisce la finestra di visualizzazione, deve essere preparata per aggiornare un rettangolo non valido nella finestra.
I flag aggiuntivi seguenti vengono usati con il tipo di dispositivo digitalvideo :
-
MCI_DGV_WINDOW_HWND
-
L'handle della finestra necessaria per l'uso come destinazione è incluso nel membro hWnd della struttura identificata da lpWindow.
-
MCI_DGV_WINDOW_STATE
-
Il membro nCmdShow della struttura identificata da lpWindow contiene parametri per impostare lo stato della finestra.
-
MCI_DGV_WINDOW_TEXT
-
Il membro lpstrText della struttura identificata da lpWindow contiene un indirizzo di un buffer contenente la didascalia utilizzata nella barra del titolo della finestra.
Per i dispositivi digital-video, il parametro lpWindow punta a una struttura MCI_DGV_WINDOW_PARMS .
I flag aggiuntivi seguenti vengono usati con il tipo di dispositivo sovrimpressione :
-
MCI_OVLY_WINDOW_DISABLE_STRETCH
-
Disabilita l'estensione dell'immagine.
-
MCI_OVLY_WINDOW_ENABLE_STRETCH
-
Abilita l'estensione dell'immagine.
-
MCI_OVLY_WINDOW_HWND
-
L'handle della finestra utilizzata per la destinazione è incluso nel membro hWnd della struttura identificata da lpWindow. Impostare questo flag su MCI_OVLY_WINDOW_DEFAULT per tornare alla finestra predefinita.
-
MCI_OVLY_WINDOW_STATE
-
Il membro nCmdShow della struttura lpWindow contiene parametri per impostare lo stato della finestra. Questo flag equivale a chiamare ShowWindow con il parametro di stato . Le costanti sono uguali a quelle definite in WINDOWS. H (ad esempio SW_HIDE, SW_MINIMIZE o SW_SHOWNORMAL).
-
MCI_OVLY_WINDOW_TEXT
-
Il membro lpstrText della struttura identificata da lpWindow contiene un indirizzo di un buffer contenente la didascalia utilizzata per la finestra.
Per i dispositivi di sovrapposizione video, il parametro lpWindow punta a una struttura MCI_OVLY_WINDOW_PARMS .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|