Funzione MCIWndCreateA (vfw.h)

Articolo
11/20/2024

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 nella finestra padre.

hInstance

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

dwStyle

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

Valore	Significato
MCIWNDF_NOAUTOSIZEWINDOW	Non modificherà le dimensioni di una finestra MCIWnd quando cambiano le dimensioni dell'immagine.
MCIWNDF_NOAUTOSIZEMOVIE	Non modificherà le dimensioni del rettangolo di destinazione quando le dimensioni di una finestra MCIWnd cambiano.
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 relativo menu a comparsa.
MCIWNDF_NOOPEN	Nasconde i comandi aperti e vicini 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 quando invia una notifica alla finestra padre della modalità dispositivo cambia. Questo flag viene usato in combinazione con MCIWNDF_NOTIFYMODE.
MCIWNDF_NOTIFYMODE	Fa sì che MCIWnd comunicherà alla finestra padre un messaggio di MCIWNDM_NOTIFYMODE ogni volta che il dispositivo cambia le modalità operative. Il parametro lParam di questo messaggio identifica la nuova modalità, ad esempio MCI_MODE_STOP.
MCIWNDF_NOTIFYPOS	Fa sì che MCIWnd comunichi alla finestra padre 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	Fa sì che MCIWnd informi la 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 file.
MCIWNDF_NOTIFYSIZE	Fa sì che MCIWnd avvii la finestra padre quando le dimensioni della finestra MCIWnd cambiano.
MCIWNDF_NOTIFYERROR	Fa sì che MCIWnd avvii la finestra padre quando si verifica un errore MCI.
MCIWNDF_NOTIFYALL	Fa sì che vengano usati tutti gli stili di notifica della finestra MCIWNDF.
MCIWNDF_RECORD	Aggiunge un pulsante Registra alla barra degli strumenti e aggiunge un nuovo comando file al menu se il dispositivo MCI ha funzionalità di registrazione.
MCIWNDF_SHOWALL	Determina l'utilizzo 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 MCI aperto o del file di dati 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 MCI o di un file di dati da aprire.

Valore restituito

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

Osservazioni

Gli stili di finestra predefiniti per una finestra figlio sono WS_CHILD, WS_BORDER e WS_VISIBLE. MCIWndCreate presuppone che venga specificata una finestra figlio quando viene specificato un handle null nonNULL 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.

Utilizzare l'handle di finestra restituito da questa funzione per l'handle di 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	vfw.h
libreria	Vfw32.lib
dll	Msvfw32.dll

Vedere anche

MCIWndGetMode

Condividi tramite