comando MCI_WINDOW

Articolo
06/13/2023

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	Mmsystem.h (include Windows.h)

Vedi anche

MCI
Comandi MCI

Condividi tramite