comando MCI_OPEN
El comando MCI_OPEN inicializa un dispositivo o archivo. Todos los dispositivos reconocen este comando.
Para enviar este comando, llame a la función mciSendCommand con los parámetros siguientes.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_OPEN,
DWORD dwFlags,
(DWORD) (LPMCI_OPEN_PARMS) lpOpen
);
Parámetros
-
wDeviceID
-
Identificador de dispositivo del dispositivo MCI que va a recibir el mensaje de comando.
-
dwFlags
-
MCI_NOTIFY o MCI_WAIT. Para obtener información sobre estas marcas, vea Las marcas Wait, Notify y Test.
-
lpOpen
-
Puntero a una estructura de MCI_OPEN_PARMS . (Los dispositivos con conjuntos de comandos extendidos pueden reemplazar esta estructura por una estructura específica del dispositivo).
Valor devuelto
Devuelve cero si es correcto o si se produce un error en caso contrario.
Comentarios
La marca MCI_OPEN_TYPE debe usarse cada vez que se especifica un dispositivo en la función mciSendCommand . Si abre un dispositivo especificando una constante de tipo de dispositivo, debe especificar la marca MCI_OPEN_TYPE_ID además de MCI_OPEN_TYPE. Para obtener una lista de constantes de tipo de dispositivo, consulte Tipos de dispositivo MCI.
Si no se especifica la marca de MCI_OPEN_SHAREABLE cuando se abre inicialmente un dispositivo o archivo, se producirá un error en todos los comandos de MCI_OPEN posteriores en el dispositivo o archivo. Si el dispositivo o el archivo ya están abiertos y no se especifica esta marca, se producirá un error en la llamada incluso si el primer comando abierto especificó MCI_OPEN_SHAREABLE. Archivos abiertos para MCISEQ. DRV y MCIWAVE. Los dispositivos DRV no se pueden compartir.
El caso se omite en el nombre del dispositivo, pero no puede haber espacios en blanco iniciales o finales.
Para usar la selección automática de tipos (a través de las entradas del Registro), asigne el nombre de archivo y la extensión de archivo al miembro lpstrElementName de la estructura identificada por lpOpen, establezca el miembro lpstrDeviceType en NULL y establezca la marca MCI_OPEN_ELEMENT.
Las siguientes marcas adicionales se aplican a todos los dispositivos que admiten MCI_OPEN:
-
MCI_OPEN_ALIAS
-
Un alias se incluye en el miembro lpstrAlias de la estructura identificada por lpOpen.
-
MCI_OPEN_SHAREABLE
-
El dispositivo o archivo debe abrirse como compartible.
-
MCI_OPEN_TYPE
-
Un nombre de tipo de dispositivo o constante se incluye en el miembro lpstrDeviceType de la estructura identificada por lpOpen.
-
MCI_OPEN_TYPE_ID
-
La palabra de orden bajo del miembro lpstrDeviceType de la estructura identificada por lpOpen contiene un identificador de tipo de dispositivo MCI estándar y la palabra de orden superior contiene opcionalmente el índice ordinal del dispositivo. Use esta marca con la marca MCI_OPEN_TYPE.
Las siguientes marcas adicionales se aplican a los dispositivos compuestos:
-
MCI_OPEN_ELEMENT
-
Un nombre de archivo se incluye en el miembro lpstrElementName de la estructura identificada por lpOpen.
-
MCI_OPEN_ELEMENT_ID
-
El miembro lpstrElementName de la estructura identificada por lpOpen se interpreta como un valor DWORD y tiene significado interno para el dispositivo. Use esta marca con la marca MCI_OPEN_ELEMENT.
Las siguientes marcas adicionales se usan con el tipo de dispositivo digitalvideo :
-
MCI_DGV_OPEN_NOSTATIC
-
El dispositivo debe reducir el número de colores estáticos (sistema) en la paleta. Esto aumenta el número de colores disponibles para representar la secuencia de vídeo. Esta marca solo se aplica a los dispositivos que comparten una paleta con Windows.
-
MCI_DGV_OPEN_PARENT
-
El identificador de ventana principal se especifica en el miembro hWndParent de la estructura identificada por lpOpen.
-
MCI_DGV_OPEN_WS
-
Se especifica un estilo de ventana en el miembro dwStyle de la estructura identificada por lpOpen.
-
MCI_DGV_OPEN_16BIT
-
Indica una preferencia para la compatibilidad con dispositivos MCI de 16 bits.
-
MCI_DGV_OPEN_32BIT
-
Indica una preferencia para la compatibilidad con dispositivos MCI de 32 bits.
En el caso de los dispositivos de vídeo digital, el parámetro lpOpen apunta a una estructura de MCI_DGV_OPEN_PARMS .
Las siguientes marcas adicionales se usan con el tipo de dispositivo superpuesto :
-
MCI_OVLY_OPEN_PARENT
-
El identificador de ventana principal se especifica en el miembro hWndParent de la estructura identificada por lpOpen.
-
MCI_OVLY_OPEN_WS
-
Se especifica un estilo de ventana en el miembro dwStyle de la estructura identificada por lpOpen. El valor dwStyle especifica el estilo de la ventana que el controlador creará y mostrará si la aplicación no proporciona una. El parámetro style toma un entero que define el estilo de ventana. Estas constantes son las mismas que los estilos de ventana estándar (como WS_CHILD, WS_OVERLAPPEDWINDOW o WS_POPUP).
En el caso de los dispositivos de superposición de vídeo, el parámetro lpOpen apunta a una estructura de MCI_OVLY_OPEN_PARMS .
La siguiente marca adicional se usa con el tipo de dispositivo waveaudio :
-
MCI_WAVE_OPEN_BUFFER
-
Se especifica una longitud de búfer en el miembro dwBufferSeconds de la estructura identificada por lpOpen.
En el caso de los dispositivos de audio de forma de onda, el parámetro lpOpen apunta a una estructura de MCI_WAVE_OPEN_PARMS . El controlador MCIWAVE requiere un dispositivo asincrónico de audio de forma de onda.
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] |
| Encabezado |
|