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
);
-
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.)
Retorna zero se tiver êxito ou um erro de outra forma.
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 .
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 |
|