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

Consulte también

MCIWNDM_NOTIFYMEDIA

MCIWNDM_NOTIFYMODE

MCIWNDM_NOTIFYPOS

MCIWndGetMode

MCIWndRegisterClass