comando open

O comando open inicializa um dispositivo. Todos os dispositivos MCI reconhecem esse comando.

Para enviar esse comando, chame a função mciSendString com o parâmetro lpszCommand definido da seguinte maneira.

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

Parâmetros

lpszDevice

Identificador de um dispositivo MCI ou driver de dispositivo. Isso pode ser um nome de dispositivo (conforme fornecido no registro ou no arquivo SYSTEM.INI) ou o nome do arquivo do driver do dispositivo. Se você especificar o nome do arquivo do driver do dispositivo, opcionalmente poderá incluir o . Extensão DRV, mas você não deve incluir o caminho para o arquivo.

lpszOpenFlags

Sinalizador que identifica o que inicializar. A tabela a seguir lista os tipos de dispositivo que reconhecem o comando open e os sinalizadores usados por cada tipo.

Valor	Significado	Significado
cdaudio	alias device_aliasfragmentável	tipo device_type
digitalvideo	alias device_aliaselementnamesharable de hwndpai nostáltico	estilo de estilo filho estilo pop-up sobreposto estilo style_typetipo device_type
overlay	alias device_aliasfilho de estilo fragmentável de hwndpai	estilo sobreposto estilo pop-up estilo style_typetipo device_type
sequenciador	alias device_alias fragmentável	tipo device_type
Videocassete	alias device_aliasfragmentável	tipo device_type
videodisk	alias device_aliasfragmentável	tipo device_type
Waveaudio	alias device_aliasbuffer buffer_size	tipo sharable device_type

A tabela a seguir lista os sinalizadores que podem ser especificados no parâmetro lpszOpenFlags e seus significados.

Valor	Significado
alias device_alias	Especifica um nome alternativo para o dispositivo especificado. Se especificado, ele deve ser usado como o device_id em comandos subsequentes.
Elementname	Especifica o nome do elemento de dispositivo (arquivo) carregado quando o dispositivo é aberto.
buffer buffer_size	Define o tamanho, em segundos, do buffer usado pelo dispositivo waveform-audio. O tamanho padrão do buffer é definido quando o dispositivo waveform-audio é instalado ou configurado. Normalmente, o tamanho do buffer é definido como 4 segundos. Com o dispositivo MCIWAVE, o tamanho mínimo é de 2 segundos e o tamanho máximo é de 9 segundos.
pai hwnd	Especifica o identificador de janela da janela pai.
Compartilhável	Inicializa o dispositivo ou arquivo como fragmentável. As tentativas subsequentes de abrir o dispositivo ou arquivo falham, a menos que você especifique "fragmentável" nos comandos abertos originais e subsequentes. O MCI retornará um erro de dispositivo inválido se o dispositivo já estiver aberto e não estiver fragmentável. Os dispositivos MCISEQ sequencer e MCIWAVE não dão suporte a arquivos compartilhados.
filho estilo	Abre uma janela com um estilo de janela filho.
estilo sobreposto	Abre uma janela com um estilo de janela sobreposto.
pop-up de estilo	Abre uma janela com um estilo de janela pop-up.
style_type de estilo	Indica um estilo de janela.
tipo device_type	Especifica o tipo de dispositivo de um arquivo.

lpszFlags

Pode ser "wait", "notify" ou ambos. Para obter mais informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

Valor Retornado

Retorna zero se tiver êxito ou um erro de outra forma.

Comentários

O MCI reserva "cdaudio" para o tipo de dispositivo de áudio CD, "videodisc" para o tipo de dispositivo videodisc, "sequencer" para o tipo de dispositivo de sequenciador MIDI, "AVIVideo" para o tipo de dispositivo de vídeo digital e "waveaudio" para o tipo de dispositivo waveform-audio.

Como alternativa ao sinalizador de "tipo", o MCI pode selecionar o dispositivo com base na extensão usada pelo arquivo, conforme registrado no registro ou na seção [extensão mci] do arquivo SYSTEM.INI.

O MCI pode abrir arquivos AVI usando um ponteiro de interface de arquivo ou um ponteiro de interface de fluxo. Para abrir um arquivo usando qualquer tipo de ponteiro de interface, especifique um sinal (@) seguido pelo ponteiro da interface no lugar do nome do arquivo ou do dispositivo para o parâmetro lpszDevice . Para obter mais informações sobre as interfaces de fluxo e arquivo, consulte " AVIFile Functions and Macros".

O comando a seguir abre o dispositivo "mysound".

open new type waveaudio alias mysound buffer 6

Com o nome do dispositivo "new", o driver de forma de onda prepara um novo recurso de forma de onda. O comando atribui o alias do dispositivo "mysound" e especifica um buffer de 6 segundos.

Você poderá eliminar o sinalizador de "tipo" se combinar o nome do dispositivo com o nome do arquivo. O MCI reconhece essa combinação quando você usa a seguinte sintaxe:

device_name ! Element_name

O ponto de exclamação separa o nome do dispositivo do nome do arquivo. O ponto de exclamação não deve ser delimitado por espaços em branco.

O exemplo a seguir abre o RIGHT. Arquivo WAV usando o dispositivo "waveaudio".

open waveaudio!right.wav

O driver MCIWAVE requer um dispositivo de áudio de forma de onda assíncrona.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Corecrt_io.h

Confira também

MCI

Cadeias de caracteres de comando MCI