Compartir a través de


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
Mmsystem.h (incluya Windows.h)

Consulte también

MCI

Comandos MCI