Función MCIWndCreateA (vfw.h)
La función MCIWndCreate registra la clase de ventana MCIWnd y crea una ventana MCIWnd para usar servicios MCI. MCIWndCreate también puede abrir un archivo o dispositivo MCI (como un archivo AVI) y asociarlo a la ventana MCIWnd.
Sintaxis
HWND VFWAPIV MCIWndCreateA(
HWND hwndParent,
HINSTANCE hInstance,
DWORD dwStyle,
LPCSTR szFile
);
Parámetros
hwndParent
Identificador de la ventana primaria.
hInstance
Identificador de la instancia del módulo que se va a asociar a la ventana MCIWnd.
dwStyle
Marcas que definen el estilo de ventana. Además de especificar los estilos de ventana usados con la función CreateWindowEx , puede especificar los siguientes estilos para usarlos con las ventanas MCIWnd.
| Valor | Significado |
|---|---|
| MCIWNDF_NOAUTOSIZEWINDOW | No cambiará las dimensiones de una ventana MCIWnd cuando cambie el tamaño de la imagen. |
| MCIWNDF_NOAUTOSIZEMOVIE | No cambiará las dimensiones del rectángulo de destino cuando cambie el tamaño de una ventana MCIWnd. |
| MCIWNDF_NOERRORDLG | Impide la visualización de errores de MCI a los usuarios. |
| MCIWNDF_NOMENU | Oculta el botón Menú de la vista en la barra de herramientas y prohíbe que los usuarios accedan a su menú emergente. |
| MCIWNDF_NOOPEN | Oculta los comandos abiertos y cerrados del menú MCIWnd y prohíbe a los usuarios acceder a estas opciones en el menú emergente. |
| MCIWNDF_NOPLAYBAR | Oculta la barra de herramientas de la vista y prohíbe a los usuarios acceder a ella. |
| MCIWNDF_NOTIFYANSI | Hace que MCIWnd use una cadena ANSI en lugar de una cadena Unicode al notificar a la ventana primaria los cambios en el modo de dispositivo. Esta marca se usa en combinación con MCIWNDF_NOTIFYMODE. |
| MCIWNDF_NOTIFYMODE | Hace que MCIWnd notifique a la ventana primaria un mensaje de MCIWNDM_NOTIFYMODE cada vez que el dispositivo cambia los modos de funcionamiento. El parámetro lParam de este mensaje identifica el nuevo modo, como MCI_MODE_STOP. |
| MCIWNDF_NOTIFYPOS | Hace que MCIWnd notifique a la ventana primaria un mensaje de MCIWNDM_NOTIFYPOS siempre que se produzca un cambio en la posición de reproducción o registro dentro del contenido. El parámetro lParam de este mensaje contiene la nueva posición en el contenido. |
| MCIWNDF_NOTIFYMEDIA | Hace que MCIWnd notifique a la ventana primaria un mensaje de MCIWNDM_NOTIFYMEDIA cada vez que se usa un nuevo dispositivo o se abre o se cierra un archivo de datos. El parámetro lParam de este mensaje contiene un puntero al nuevo nombre de archivo. |
| MCIWNDF_NOTIFYSIZE | Hace que MCIWnd notifique a la ventana primaria cuando cambia el tamaño de la ventana MCIWnd. |
| MCIWNDF_NOTIFYERROR | Hace que MCIWnd notifique a la ventana primaria cuando se produce un error de MCI. |
| MCIWNDF_NOTIFYALL | Hace que se usen todos los estilos de notificación de ventana de MCIWNDF. |
| MCIWNDF_RECORD | Agrega un botón Grabar a la barra de herramientas y agrega un nuevo comando de archivo al menú si el dispositivo MCI tiene la capacidad de grabación. |
| MCIWNDF_SHOWALL | Hace que se usen todos los estilos MCIWNDF_SHOW. |
| MCIWNDF_SHOWMODE | Muestra el modo actual del dispositivo MCI en la barra de título de la ventana. Para obtener una lista de los modos de dispositivo, consulte la macro MCIWndGetMode . |
| MCIWNDF_SHOWNAME | Muestra el nombre del archivo de datos o dispositivo MCI abierto en la barra de título de la ventana MCIWnd. |
| MCIWNDF_SHOWPOS | Muestra la posición actual dentro del contenido del dispositivo MCI en la barra de título de la ventana. |
szFile
Cadena terminada en null que indica el nombre de un dispositivo MCI o un archivo de datos que se va a abrir.
Valor devuelto
Devuelve el identificador a una ventana de MCI si es correcta o cero de lo contrario.
Comentarios
Los estilos de ventana predeterminados de una ventana secundaria son WS_CHILD, WS_BORDER y WS_VISIBLE. MCIWndCreate asume una ventana secundaria cuando se especifica un identificador que no es NULL de una ventana primaria.
Los estilos de ventana predeterminados de una ventana primaria son WS_OVERLAPPEDWINDOW y WS_VISIBLE. MCIWndCreate asume una ventana primaria cuando se especifica un identificador NULL de una ventana primaria.
Use el identificador de ventana devuelto por esta función para el identificador de ventana en las macros MCIWnd. Si la aplicación usa esta función, no es necesario usar la función MCIWndRegisterClass .
Nota
El encabezado vfw.h define MCIWndCreate como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vfw.h |
| Library | Vfw32.lib |
| Archivo DLL | Msvfw32.dll |