Compartilhar via


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