Estrutura CAPSTATUS (vfw.h)

A estrutura CAPSTATUS define o estado atual da janela de captura.

Sintaxe

typedef struct tagCapStatus {
  UINT     uiImageWidth;
  UINT     uiImageHeight;
  BOOL     fLiveWindow;
  BOOL     fOverlayWindow;
  BOOL     fScale;
  POINT    ptScroll;
  BOOL     fUsingDefaultPalette;
  BOOL     fAudioHardware;
  BOOL     fCapFileExists;
  DWORD    dwCurrentVideoFrame;
  DWORD    dwCurrentVideoFramesDropped;
  DWORD    dwCurrentWaveSamples;
  DWORD    dwCurrentTimeElapsedMS;
  HPALETTE hPalCurrent;
  BOOL     fCapturingNow;
  DWORD    dwReturn;
  UINT     wNumVideoAllocated;
  UINT     wNumAudioAllocated;
} CAPSTATUS, *PCAPSTATUS, *LPCAPSTATUS;

Membros

uiImageWidth

Largura da imagem, em pixels.

uiImageHeight

Altura da imagem, em pixels

fLiveWindow

Sinalizador de janela dinâmica. O valor desse membro será TRUE se a janela estiver exibindo vídeo usando o método de visualização.

fOverlayWindow

Sinalizador de janela de sobreposição. O valor desse membro será TRUE se a janela estiver exibindo vídeo usando a sobreposição de hardware.

fScale

Sinalizador de dimensionamento de entrada. O valor desse membro será TRUE se a janela estiver dimensionando o vídeo de entrada para a área do cliente ao exibir vídeo usando a versão prévia. Esse parâmetro não tem efeito ao exibir vídeo usando sobreposição.

ptScroll

O deslocamento x e y do pixel exibido no canto superior esquerdo da área do cliente da janela.

fUsingDefaultPalette

Sinalizador de paleta padrão. O valor desse membro será TRUE se o driver de captura estiver usando sua paleta padrão.

fAudioHardware

Sinalizador de hardware de áudio. O valor desse membro será TRUE se o sistema tiver o hardware waveform-audio instalado.

fCapFileExists

Sinalizador de arquivo de captura. O valor desse membro será TRUE se um arquivo de captura válido tiver sido gerado.

dwCurrentVideoFrame

Número de quadros processados durante a captura de streaming atual (ou mais recente). Essa contagem inclui quadros descartados.

dwCurrentVideoFramesDropped

Número de quadros removidos durante a captura de streaming atual (ou mais recente). Os quadros removidos ocorrem quando a taxa de captura excede a taxa na qual os quadros podem ser salvos no arquivo. Nesse caso, o driver de captura não tem buffers disponíveis para armazenar dados. Soltar quadros não afeta a sincronização porque o quadro anterior é exibido no lugar do quadro descartado.

dwCurrentWaveSamples

Número de amostras de áudio de forma de onda processadas durante a captura de streaming atual (ou mais recente).

dwCurrentTimeElapsedMS

Tempo, em milissegundos, desde o início da captura de streaming atual (ou mais recente).

hPalCurrent

Manipule para a paleta atual.

fCapturingNow

Sinalizador de captura. O valor desse membro é TRUE quando a captura está em andamento.

dwReturn

Erro ao retornar valores. Use esse membro se o aplicativo não der suporte a uma função de retorno de chamada de erro.

wNumVideoAllocated

Número de buffers de vídeo alocados. Esse valor pode ser menor que o número especificado no membro wNumVideoRequested da estrutura CAPTUREPARMS .

wNumAudioAllocated

Número de buffers de áudio alocados. Esse valor pode ser menor que o número especificado no membro wNumAudioRequested da estrutura CAPTUREPARMS .

Comentários

Como o estado de uma janela de captura é alterado em resposta a várias mensagens, um aplicativo deve atualizar as informações nessa estrutura sempre que precisar habilitar itens de menu, determinar o estado real da janela de captura ou chamar a caixa de diálogo de formato de vídeo. Se o aplicativo produzir durante a captura de streaming, essa estrutura retornará o progresso da captura nos membros dwCurrentVideoFrame, dwCurrentVideoFramesDropped, dwCurrentWaveSamples e dwCurrentTimeElapsedMS . Use a mensagem WM_CAP_GET_STATUS ou a macro capGetStatus para atualizar o conteúdo dessa estrutura.

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

Confira também

CAPTUREPARMS

Captura de vídeo

Estruturas de captura de vídeo

WM_CAP_GET_STATUS