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