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
Captura de vídeo