Compartilhar via


comando MCI_CAPTURE

O comando MCI_CAPTURE captura o conteúdo do buffer de quadro e o armazena em um arquivo especificado. Os dispositivos de vídeo digital reconhecem esse comando.

Para enviar esse comando, chame a função mciSendCommand com os parâmetros a seguir.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_CAPTURE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_CAPTURE_PARMS) lpCapture
);

Parâmetros

wDeviceID

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

dwFlags

MCI_NOTIFY, MCI_WAIT ou MCI_TEST. Para obter informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

lpCapture

Ponteiro para uma estrutura MCI_DGV_CAPTURE_PARMS .

Valor Retornado

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

Comentários

Os seguintes sinalizadores adicionais se aplicam a dispositivos de vídeo digital:

MCI_DGV_CAPTURE_AS

O membro lpstrFileName da estrutura identificada por lpCapture contém um endereço de um buffer que especifica o caminho de destino e o nome do arquivo. (Esse sinalizador é necessário.)

MCI_DGV_CAPTURE_AT

O membro rc da estrutura identificada por lpCapture contém um retângulo válido. O retângulo especifica a região retangular dentro do buffer de quadro que é cortado e salvo em disco. Se omitida, a região cortada usará como padrão o retângulo especificado ou padronizado em um comando MCI_PUT anterior que especifica a área de origem para essa instância do driver de dispositivo.

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