Funzione MCIWndCreateA (vfw.h)

Articolo
08/27/2023

La funzione MCIWndCreate registra la classe finestra MCIWnd e crea una finestra MCIWnd per l'uso dei servizi MCI. MCIWndCreate può anche aprire un dispositivo o un file MCI (ad esempio un file AVI) e associarlo alla finestra MCIWnd.

Sintassi

HWND VFWAPIV MCIWndCreateA(
  HWND      hwndParent,
  HINSTANCE hInstance,
  DWORD     dwStyle,
  LPCSTR    szFile
);

Parametri

hwndParent

Handle per la finestra padre.

hInstance

Gestire l'istanza del modulo da associare alla finestra MCIWnd.

dwStyle

Contrassegni che definiscono lo stile della finestra. Oltre a specificare gli stili della finestra usati con la funzione CreateWindowEx , è possibile specificare gli stili seguenti da usare con le finestre MCIWnd.

Valore	Significato
MCIWNDF_NOAUTOSIZEWINDOW	Non modifica le dimensioni di una finestra MCIWnd quando le dimensioni dell'immagine cambiano.
MCIWNDF_NOAUTOSIZEMOVIE	Non modifica le dimensioni del rettangolo di destinazione quando cambiano le dimensioni di una finestra MCIWnd.
MCIWNDF_NOERRORDLG	Impedisce la visualizzazione degli errori mcI agli utenti.
MCIWNDF_NOMENU	Nasconde il pulsante Menu dalla visualizzazione sulla barra degli strumenti e impedisce agli utenti di accedere al menu a comparsa.
MCIWNDF_NOOPEN	Nasconde i comandi aperti e chiudi dal menu MCIWnd e impedisce agli utenti di accedere a queste scelte nel menu a comparsa.
MCIWNDF_NOPLAYBAR	Nasconde la barra degli strumenti dalla visualizzazione e impedisce agli utenti di accedervi.
MCIWNDF_NOTIFYANSI	Fa sì che MCIWnd usi una stringa ANSI anziché una stringa Unicode durante la notifica alla finestra padre delle modifiche della modalità dispositivo. Questo flag viene usato in combinazione con MCIWNDF_NOTIFYMODE.
MCIWNDF_NOTIFYMODE	Causa la notifica a MCIWnd alla finestra padre con un messaggio MCIWNDM_NOTIFYMODE ogni volta che il dispositivo modifica le modalità operative. Il parametro lParam di questo messaggio identifica la nuova modalità, ad esempio MCI_MODE_STOP.
MCIWNDF_NOTIFYPOS	Causa la notifica a MCIWnd alla finestra padre con un messaggio di MCIWNDM_NOTIFYPOS ogni volta che si verifica una modifica nella posizione di riproduzione o record all'interno del contenuto. Il parametro lParam di questo messaggio contiene la nuova posizione nel contenuto.
MCIWNDF_NOTIFYMEDIA	Causa la notifica a MCIWnd alla finestra padre con un messaggio di MCIWNDM_NOTIFYMEDIA ogni volta che viene usato un nuovo dispositivo o un file di dati viene aperto o chiuso. Il parametro lParam di questo messaggio contiene un puntatore al nuovo nome del file.
MCIWNDF_NOTIFYSIZE	Causa la modifica delle dimensioni della finestra mcIWnd quando le dimensioni della finestra MCIWnd cambiano.
MCIWNDF_NOTIFYERROR	Causa la notifica a MCIWnd alla finestra padre quando si verifica un errore MCI.
MCIWNDF_NOTIFYALL	Causa l'uso di tutti gli stili di notifica della finestra MCIWNDF.
MCIWNDF_RECORD	Aggiunge un pulsante Record alla barra degli strumenti e aggiunge un nuovo comando di file al menu se il dispositivo MCI ha la funzionalità di registrazione.
MCIWNDF_SHOWALL	Causa l'uso di tutti gli stili MCIWNDF_SHOW.
MCIWNDF_SHOWMODE	Visualizza la modalità corrente del dispositivo MCI nella barra del titolo della finestra. Per un elenco delle modalità dispositivo, vedere la macro MCIWndGetMode .
MCIWNDF_SHOWNAME	Visualizza il nome del dispositivo o del file di dati MCI aperto nella barra del titolo della finestra MCIWnd.
MCIWNDF_SHOWPOS	Visualizza la posizione corrente all'interno del contenuto del dispositivo MCI nella barra del titolo della finestra.

szFile

Stringa con terminazione null che indica il nome di un dispositivo o di un file di dati MCI da aprire.

Valore restituito

Restituisce l'handle a una finestra MCI se ha esito positivo o zero in caso contrario.

Commenti

Gli stili di finestra predefiniti per una finestra figlio sono WS_CHILD, WS_BORDER e WS_VISIBLE. MCIWndCreate presuppone una finestra figlio quando viene specificato un handle non NULL di una finestra padre.

Gli stili di finestra predefiniti per una finestra padre sono WS_OVERLAPPEDWINDOW e WS_VISIBLE. MCIWndCreate presuppone una finestra padre quando viene specificato un handle NULL di una finestra padre.

Usare l'handle della finestra restituito da questa funzione per l'handle della finestra nelle macro MCIWnd. Se l'applicazione usa questa funzione, non è necessario usare la funzione MCIWndRegisterClass .

Nota

L'intestazione vfw.h definisce MCIWndCreate come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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	vfw.h
Libreria	Vfw32.lib
DLL	Msvfw32.dll

Vedi anche