Compartilhar via


comando capture

O comando capture copia o conteúdo do buffer de quadro e o armazena no arquivo especificado. Os dispositivos de vídeo digital reconhecem esse comando.

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

_stprintf_s(
  lpszCommand, 
  TEXT("capture %s %s %s"), 
  lpszDeviceID, 
  lpszCapture, 
  lpszFlags
); 

Parâmetros

lpszDeviceID

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

lpszCapture

Um ou mais dos seguintes sinalizadores:

Valor Significado
como pathname Especifica o caminho de destino e o nome do arquivo para a imagem capturada. Este sinalizador é necessário.
no retângulo Especifica a região retangular dentro do buffer de quadros que o dispositivo corta e salva no disco. Se omitida, a região cortada usará como padrão o retângulo especificado ou padronizado em um comando anterior put "source" para esta instância do dispositivo.

lpszFlags

Pode ser "wait", "notify", "test" ou uma combinação delas. 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

Esse comando poderá falhar se o dispositivo estiver reproduzindo vídeo em movimento ou executando alguma outra operação com uso intensivo de recursos. Se o buffer de quadro estiver sendo atualizado em tempo real, a atualização pausará momentaneamente para que uma imagem completa seja capturada. Se o dispositivo pausar a atualização, pode haver um efeito visual ou audível. Se o formato do arquivo, o algoritmo de compactação e os níveis de qualidade não tiverem sido definidos, seus padrões serão usados.

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

put