Comando open

El comando open inicializa un dispositivo. Todos los dispositivos MCI reconocen este comando.

Para enviar este comando, llame a la función mciSendString con el parámetro lpszCommand establecido de la siguiente manera.

_stprintf_s(
  lpszCommand, 
  TEXT("open %s %s %s"), 
  lpszDevice, 
  lpszOpenFlags, 
  lpszFlags
); 

Parámetros

lpszDevice

Identificador de un dispositivo MCI o un controlador de dispositivo. Puede ser un nombre de dispositivo (como se indica en el registro o en el archivo SYSTEM.INI) o el nombre de archivo del controlador de dispositivo. Si especifica el nombre de archivo del controlador de dispositivo, puede incluir opcionalmente . Extensión DRV, pero no debe incluir la ruta de acceso al archivo.

lpszOpenFlags

Marca que identifica lo que se va a inicializar. En la tabla siguiente se enumeran los tipos de dispositivo que reconocen el comando open y las marcas usadas por cada tipo.

Valor	Significado	Significado
cdaudio	alias device_aliasse puede compartir	tipo device_type
digitalvideo	alias device_aliaselementnamenostatic parent hwnd sharable	estilo secundario estilo estilo superpuesto estilo emergente style_typetipo device_type
overlay	alias device_aliaselemento secundario de estilo que se puede compartir con hwndprimario	estilo superpuesto estilo estilo emergente style_typetipo device_type
sequencer	alias device_alias se puede compartir	tipo device_type
Vcr	alias device_aliasse puede compartir	tipo device_type
videodisk	alias device_aliasse puede compartir	tipo device_type
waveaudio	alias device_alias buffer_sizede búfer	device_type de tipo que se puede compartir

En la tabla siguiente se enumeran las marcas que se pueden especificar en el parámetro lpszOpenFlags y sus significados.

Valor	Significado
alias device_alias	Especifica un nombre alternativo para el dispositivo especificado. Si se especifica, se debe usar como device_id en comandos posteriores.
Elementname	Especifica el nombre del elemento de dispositivo (archivo) cargado cuando se abre el dispositivo.
buffer_size de búfer	Establece el tamaño, en segundos, del búfer utilizado por el dispositivo de audio de forma de onda. El tamaño predeterminado del búfer se establece cuando se instala o configura el dispositivo de audio con forma de onda. Normalmente, el tamaño del búfer se establece en 4 segundos. Con el dispositivo MCIWAVE, el tamaño mínimo es de 2 segundos y el tamaño máximo es de 9 segundos.
parent hwnd	Especifica el identificador de ventana de la ventana primaria.
que se puede compartir	Inicializa el dispositivo o archivo como compartible. Los intentos posteriores de abrir el dispositivo o el archivo producen un error a menos que especifique "sharable" en los comandos abiertos originales y posteriores. MCI devuelve un error de dispositivo no válido si el dispositivo ya está abierto y no se puede compartir. Los dispositivos MCISEQ y MCIWAVE no admiten archivos compartidos.
style secundario	Abre una ventana con un estilo de ventana secundario.
estilo superpuesto	Abre una ventana con un estilo de ventana superpuesto.
elemento emergente style	Abre una ventana con un estilo de ventana emergente.
style_type de estilo	Indica un estilo de ventana.
tipo device_type	Especifica el tipo de dispositivo de un archivo.

lpszFlags

Puede ser "wait", "notify" o ambos. Para obtener más información sobre estas marcas, vea Las marcas Wait, Notify y Test.

Valor devuelto

Devuelve cero si es correcto o si se produce un error de lo contrario.

Comentarios

MCI reserva "cdaudio" para el tipo de dispositivo de audio cd, "videodisc" para el tipo de dispositivo videodisc, "secuenciador" para el tipo de dispositivo de secuenciador MIDI, "AVIVideo" para el tipo de dispositivo de vídeo digital y "waveaudio" para el tipo de dispositivo waveform-audio.

Como alternativa a la marca "type", MCI puede seleccionar el dispositivo en función de la extensión utilizada por el archivo, como se registra en el Registro o en la sección [extensión mci] del archivo SYSTEM.INI.

MCI puede abrir archivos AVI mediante un puntero de interfaz de archivo o un puntero de interfaz de secuencia. Para abrir un archivo mediante cualquier tipo de puntero de interfaz, especifique un signo at (@) seguido del puntero de interfaz en lugar del archivo o el nombre del dispositivo para el parámetro lpszDevice . Para obtener más información sobre las interfaces de archivos y secuencias, vea " Funciones y macros AVIFile".

El siguiente comando abre el dispositivo "mysound".

open new type waveaudio alias mysound buffer 6

Con el nombre del dispositivo "new", el controlador de forma de onda prepara un nuevo recurso de forma de onda. El comando asigna el alias de dispositivo "mysound" y especifica un búfer de 6 segundos.

Puedes eliminar la marca "type" si combinas el nombre del dispositivo con el nombre de archivo. MCI reconoce esta combinación cuando se usa la sintaxis siguiente:

device_name ! element_name

El signo de exclamación separa el nombre del dispositivo del nombre de archivo. Los espacios en blanco no deben delimitar el signo de exclamación.

En el ejemplo siguiente se abre right. Archivo WAV con el dispositivo "waveaudio".

open waveaudio!right.wav

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	Corecrt_io.h

Consulte también

MCI

Cadenas de comandos de MCI