comando record

O comando de registro inicia a gravação de dados. Os dispositivos vcr e waveform-audio reconhecem esse comando. Embora os dispositivos de vídeo digital e os sequenciadores MIDI também reconheçam esse comando, os drivers MCIAVI e MCISEQ não o implementam.

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

_stprintf_s(
  lpszCommand, 
  TEXT("record %s %s %s"), 
  lpszDeviceID, 
  lpszRecordFlags, 
  lpszFlags
); 

Parâmetros

lpszDeviceID

Identificador de um dispositivo MCI. Esse identificador ou alias é atribuído quando o dispositivo é aberto.

lpszRecordFlags

Sinalizador para gravar dados. A tabela a seguir lista os tipos de dispositivo que reconhecem o comando de registro e os sinalizadores usados por cada tipo.

Valor	Significado	Significado
digitalvideo	no fluxode áudio do retânguloda retenção de posição	inserir substituição para posicionaro fluxo de fluxo de vídeo
sequenciador	da inserção de posição	substituir para posição
Videocassete	no momentoda inicialização da posição	inserir substituição à posição
Waveaudio	da inserção de posição	substituir para posição

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

Valor	Significado
no retângulo	Especifica uma região retangular da entrada externa usada como a origem dos pixels compactados e salvos. Se não for especificado, o retângulo usará como padrão o retângulo especificado para colocar "vídeo". Quando ele é definido de forma diferente do retângulo "vídeo", a imagem exibida não é o que é gravado.
no momento	Indica quando o dispositivo deve começar a executar esse comando ou, se o dispositivo tiver sido cued, quando o comando cued for iniciado. Para obter mais informações, consulte o comando cue .
fluxo de fluxo de áudio	Especifica o fluxo de áudio usado para gravação. Se esse sinalizador não for especificado e o formato de arquivo não definir um padrão, ele será registrado no fluxo que é fisicamente primeiro.
da posição	Especifica uma posição inicial para a gravação. Se o sinalizador "from" não for especificado, o dispositivo iniciará a gravação na posição atual.
Segurar	Congela a imagem quando a gravação é concluída em vez de mostrar vídeo ao vivo. Quando a gravação é interrompida, um comando "arquivo" do monitor automático é executado. Para retornar ao vídeo ao vivo, emita o comando "entrada" do monitor .
Initialize	Inicialize a fita (mídia), que envolve a gravação do código de tempo (se possível) para vídeo e áudio em branco. Esse comando pode levar várias horas se a fita inteira precisar ser inicializada.
insert	Especifica que novos dados são adicionados ao arquivo na posição atual.
overwrite	Especifica que novos dados substituirão os dados no arquivo.
para posicionar	Especifica uma posição final para a gravação. Se o sinalizador "para" não for especificado, o dispositivo registrará até receber um comando de parada ou pausa .
fluxo de vídeo	Especifica o fluxo de vídeo usado para gravação. Se isso não for especificado e o formato do arquivo não definir um padrão, ele será registrado no fluxo que é fisicamente primeiro.

lpszFlags

Pode ser "wait", "notify" ou ambos. Para dispositivos de vídeo digital e VCR, o "teste" também pode ser especificado. 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

A gravação é interrompida quando um comando de parada ou pausa é emitido. Para o driver MCIWAVE, todos os dados registrados após a abertura de um arquivo serão descartados se o arquivo for fechado sem salvá-lo.

Antes de emitir comandos que usam valores de posição, você deve definir o formato de hora desejado usando o comando set . As faixas a serem gravadas são especificadas pelos comandos settimecode "record", set "assemble record", setvideo "record" e setaudio "record".

Exemplos

O comando a seguir inicia a gravação na posição atual.

record mysound

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]

Confira também

MCI

Cadeias de caracteres de comando MCI

Cue

Monitor

pause

put

set

Setaudio

settimecode

setvideo

stop