comando MCI_RECORD

O comando MCI_RECORD inicia a gravação da posição atual ou de um local especificado para outro local especificado. 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 mciSendCommand com os parâmetros a seguir.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_RECORD, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_RECORD_PARMS) lpRecord
);

Parâmetros

wDeviceID

Identificador de dispositivo do dispositivo MCI que deve receber a mensagem de comando.

dwFlags

MCI_NOTIFY, MCI_WAIT ou, para dispositivos de vídeo digital e VCR, MCI_TEST. Para obter informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

lpRecord

Ponteiro para uma estrutura de MCI_RECORD_PARMS . (Dispositivos com conjuntos de comandos estendidos podem substituir essa estrutura por uma estrutura específica do dispositivo.)

Valor Retornado

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

Comentários

Esse comando é compatível com dispositivos que retornam TRUE quando você chama o comando MCI_GETDEVCAPS com o sinalizador MCI_GETDEVCAPS_CAN_RECORD. 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.

Os seguintes sinalizadores adicionais se aplicam a todos os dispositivos que dão suporte a MCI_RECORD:

MCI_FROM

Um local inicial é incluído no membro dwFrom da estrutura identificada por lpRecord. As unidades atribuídas aos valores de posição são especificadas com o sinalizador MCI_SET_TIME_FORMAT do comando MCI_SET . Se MCI_FROM não for especificado, o local inicial usará como padrão a posição atual.

MCI_RECORD_INSERT

As informações recém-registradas devem ser inseridas ou coladas nos dados existentes. Alguns dispositivos podem não dar suporte a isso. Se houver suporte, esse é o padrão.

MCI_RECORD_OVERWRITE

Os dados devem substituir os dados existentes. O MCIWAVE. O dispositivo DRV retorna MCIERR_UNSUPPORTED_FUNCTION em resposta a esse sinalizador.

MCI_TO

Um local final é incluído no membro dwTo da estrutura identificada por lpRecord. As unidades atribuídas aos valores de posição são especificadas com o sinalizador MCI_SET_TIME_FORMAT do comando MCI_SET . Se MCI_TO não for especificado, o local final usará como padrão o final do conteúdo.

Os seguintes sinalizadores adicionais são usados com o tipo de dispositivo digitalvideo :

MCI_DGV_RECORD_AUDIO_STREAM

Um número de fluxo de áudio é incluído no membro dwAudioStream da estrutura identificada por lpRecord. Se você omitir esse sinalizador, os dados de áudio serão gravados no primeiro fluxo físico.

MCI_DGV_RECORD_HOLD

Quando a gravação for interrompida, a tela manterá a última imagem e não retomará a exibição do vídeo até que um comando MCI_MONITOR seja emitido.

MCI_DGV_RECORD_VIDEO_STREAM

Um número de fluxo de vídeo está incluído no membro dwVideoStream da estrutura identificada por lpRecord. Se você omitir esse sinalizador, os dados de vídeo serão gravados no primeiro fluxo físico.

MCI_DGV_RECT

Um retângulo é especificado no membro rc da estrutura identificada por lpRecord. O retângulo especifica a região da entrada externa usada como a origem dos pixels compactados e salvos. Esse retângulo usa como padrão o retângulo especificado (ou padrão) pelo sinalizador MCI_DGV_PUT_VIDEO para o comando MCI_PUT . Quando ele é definido de forma diferente do retângulo de vídeo, o que é exibido não é o que é gravado

Para dispositivos de vídeo digital, lpRecord aponta para uma estrutura MCI_DGV_RECORD_PARMS .

Os seguintes sinalizadores adicionais são usados com o tipo de dispositivo vcr :

MCI_VCR_RECORD_AT

O membro dwAt da estrutura identificada por lpRecord contém uma hora em que todo o comando começa, ou se o dispositivo é fornecido, quando o dispositivo atinge a posição de saída fornecida pelo comando de indicação.

MCI_VCR_RECORD_INITIALIZE

Procure o dispositivo até o início da mídia, comece a gravar vídeo e áudio em branco e registre o código de tempo, se possível.

Para dispositivos VCR, lpRecord aponta para uma estrutura MCI_VCR_RECORD_PARMS .

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	Mmsystem.h (inclua Windows.h)

Confira também

MCI

Comandos MCI