Estrutura CAPTUREPARMS (vfw.h)

Artigo
08/27/2023

A estrutura CAPTUREPARMS contém parâmetros que controlam o processo de captura de vídeo de streaming. Essa estrutura é usada para obter e definir parâmetros que afetam a taxa de captura, o número de buffers a serem usados durante a captura e como a captura é encerrada.

Sintaxe

typedef struct tagCaptureParms {
  DWORD dwRequestMicroSecPerFrame;
  BOOL  fMakeUserHitOKToCapture;
  UINT  wPercentDropForError;
  BOOL  fYield;
  DWORD dwIndexSize;
  UINT  wChunkGranularity;
  BOOL  fUsingDOSMemory;
  UINT  wNumVideoRequested;
  BOOL  fCaptureAudio;
  UINT  wNumAudioRequested;
  UINT  vKeyAbort;
  BOOL  fAbortLeftMouse;
  BOOL  fAbortRightMouse;
  BOOL  fLimitEnabled;
  UINT  wTimeLimit;
  BOOL  fMCIControl;
  BOOL  fStepMCIDevice;
  DWORD dwMCIStartTime;
  DWORD dwMCIStopTime;
  BOOL  fStepCaptureAt2x;
  UINT  wStepCaptureAverageFrames;
  DWORD dwAudioBufferSize;
  BOOL  fDisableWriteCache;
  UINT  AVStreamMaster;
} CAPTUREPARMS, *PCAPTUREPARMS, *LPCAPTUREPARMS;

Membros

dwRequestMicroSecPerFrame

Taxa de quadros solicitada, em microssegundos. O valor padrão é 66667, que corresponde a 15 quadros por segundo.

fMakeUserHitOKToCapture

Sinalizador de captura iniciado pelo usuário. Se esse membro for TRUE, o AVICap exibirá uma caixa de diálogo solicitando que o usuário inicie a captura. O valor padrão é FALSE.

wPercentDropForError

Porcentagem máxima permitida de quadros descartados durante a captura. Os valores variam de 0 a 100. O valor padrão é 10.

fYield

Sinalizador de rendimento. Se esse membro for TRUE, a janela de captura gerará um thread em segundo plano separado para executar a captura de etapa e streaming. O valor padrão é FALSE.

Os aplicativos que definem esse sinalizador devem lidar com possíveis problemas de reentrada porque os controles no aplicativo não estão desabilitados enquanto a captura está em andamento.

dwIndexSize

Número máximo de entradas de índice em um arquivo AVI. Os valores variam de 1800 a 324.000. Se definido como 0, um valor padrão de 34.952 (quadros de 32K mais um número proporcional de buffers de áudio) será usado.

Cada quadro de vídeo ou buffer de dados de áudio de forma de onda usa uma entrada de índice. O valor dessa entrada estabelece um limite para o número de quadros ou buffers de áudio que podem ser capturados.

wChunkGranularity

Tamanho do bloco lógico, em bytes, de um arquivo AVI. O valor 0 indica que o tamanho do setor atual é usado como a granularidade.

fUsingDOSMemory

Não usado em aplicativos Win32.

wNumVideoRequested

Número máximo de buffers de vídeo a serem alocados. A área de memória para colocar os buffers é especificada com fUsingDOSMemory. O número real de buffers alocados poderá ser menor se a memória não estiver disponível.

fCaptureAudio

Capturar sinalizador de áudio. Se esse membro for TRUE, o áudio será capturado durante a captura de streaming. Esse será o valor padrão se o hardware de áudio estiver instalado.

wNumAudioRequested

Número máximo de buffers de áudio a serem alocados. O número máximo de buffers é 10.

vKeyAbort

Código de chave virtual usado para encerrar a captura de streaming. O valor padrão é VK_ESCAPE. Você deve chamar a função RegisterHotKey antes de especificar um pressionamento de tecla que pode anular uma sessão de captura.

Você pode combinar os códigos-chave que incluem pressionamentos de teclas CTRL e SHIFT usando o operador OR lógico com os códigos de chave para CTRL (0x8000) e SHIFT (0x4000).

fAbortLeftMouse

Sinalizador de anulação do botão esquerdo do mouse. Se esse membro for TRUE, a captura de streaming será interrompida se o botão esquerdo do mouse for pressionado. O valor padrão é TRUE.

fAbortRightMouse

Sinalizador de anulação do botão direito do mouse. Se esse membro for TRUE, a captura de streaming será interrompida se o botão direito do mouse for pressionado. O valor padrão é TRUE.

fLimitEnabled

Sinalizador habilitado para limite de tempo. Se esse membro for TRUE, a captura de streaming será interrompida após o número de segundos em wTimeLimit ter decorrido. O valor padrão é FALSE.

wTimeLimit

Limite de tempo para captura, em segundos. Esse parâmetro será usado somente se fLimitEnabled for TRUE.

fMCIControl

Sinalizador de captura de dispositivo MCI. Se esse membro for TRUE, o AVICap controlará uma fonte de vídeo compatível com MCI durante a captura de streaming. As fontes de vídeo compatíveis com MCI incluem VCRs e laserdiscs.

fStepMCIDevice

Sinalizador de captura da etapa do dispositivo MCI. Se esse membro for TRUE, a captura de etapas usando um dispositivo MCI como fonte de vídeo estará habilitada. Se for FALSE, a captura em tempo real usando um dispositivo MCI estará habilitada. (Se fMCIControl for FALSE, esse membro será ignorado.)

dwMCIStartTime

Posição inicial, em milissegundos, do dispositivo MCI para a sequência de captura. (Se fMCIControl for FALSE, esse membro será ignorado.)

dwMCIStopTime

Posição de parada, em milissegundos, do dispositivo MCI para a sequência de captura. Quando essa posição no conteúdo é atingida, a captura termina e o dispositivo MCI é interrompido. (Se fMCIControl for FALSE, esse membro será ignorado.)

fStepCaptureAt2x

Sinalizador de captura de etapa de resolução dupla. Se esse membro for TRUE, o hardware de captura capturará duas vezes a resolução especificada. (A resolução para a altura e largura é dobrada.)

Habilite essa opção se o hardware não der suporte à dizimação baseada em hardware e você estiver capturando no formato RGB.

wStepCaptureAverageFrames

Número de vezes que um quadro é amostrado ao criar um quadro com base na amostra média. Um valor típico para o número de médias é 5.

dwAudioBufferSize

Tamanho do buffer de áudio. Se o valor padrão de zero for usado, o tamanho de cada buffer será o máximo de 0,5 segundos de áudio ou 10 mil bytes.

fDisableWriteCache

Não usado em aplicativos Win32.

AVStreamMaster

Indica se o fluxo de áudio controla o relógio ao gravar um arquivo AVI. Se esse membro estiver definido como AVSTREAMMASTER_AUDIO, o fluxo de áudio será considerado o fluxo de master e a duração do fluxo de vídeo será forçada a corresponder à duração do áudio. Se esse membro estiver definido como AVSTREAMMASTER_NONE, as durações dos fluxos de áudio e vídeo poderão ser diferentes.

Comentários

A macro WM_CAP_GET_SEQUENCE_SETUP mensagem ou capCaptureGetSetup é usada para recuperar os parâmetros de captura atuais. A macro WM_CAP_SET_SEQUENCE_SETUP mensagem ou capCaptureSetSetup é usada para definir os parâmetros de captura.

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	vfw.h