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 |
|