Funzione MCIWndCreateW (vfw.h)
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 MCIWndCreateW(
HWND hwndParent,
HINSTANCE hInstance,
DWORD dwStyle,
LPCWSTR 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 |