Estructura CAPSTATUS (vfw.h)

La estructura CAPSTATUS define el estado actual de la ventana de captura.

Sintaxis

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;

Miembros

uiImageWidth

Ancho de imagen, en píxeles.

uiImageHeight

Alto de la imagen, en píxeles

fLiveWindow

Marca de ventana activa. El valor de este miembro es TRUE si la ventana muestra vídeo mediante el método de vista previa.

fOverlayWindow

Marca de ventana superpuesta. El valor de este miembro es TRUE si la ventana muestra vídeo mediante la superposición de hardware.

fScale

Marca de escalado de entrada. El valor de este miembro es TRUE si la ventana está escalando el vídeo de entrada al área de cliente al mostrar vídeo mediante vista previa. Este parámetro no tiene ningún efecto al mostrar vídeo mediante superposición.

ptScroll

Desplazamiento x e y del píxel mostrado en la esquina superior izquierda del área cliente de la ventana.

fUsingDefaultPalette

Marca de paleta predeterminada. El valor de este miembro es TRUE si el controlador de captura usa su paleta predeterminada.

fAudioHardware

Marca de hardware de audio. El valor de este miembro es TRUE si el sistema tiene instalado hardware de audio de forma de onda.

fCapFileExists

Captura de la marca de archivo. El valor de este miembro es TRUE si se ha generado un archivo de captura válido.

dwCurrentVideoFrame

Número de fotogramas procesados durante la captura de streaming actual (o más reciente). Este recuento incluye fotogramas quitados.

dwCurrentVideoFramesDropped

Número de fotogramas descartados durante la captura de streaming actual (o más reciente). Los fotogramas quitados se producen cuando la velocidad de captura supera la velocidad a la que se pueden guardar los fotogramas en el archivo. En este caso, el controlador de captura no tiene búferes disponibles para almacenar datos. Quitar fotogramas no afecta a la sincronización porque el fotograma anterior se muestra en lugar del marco descartado.

dwCurrentWaveSamples

Número de muestras de audio de forma de onda procesadas durante la captura de streaming actual (o más reciente).

dwCurrentTimeElapsedMS

Tiempo, en milisegundos, desde el inicio de la captura de streaming actual (o más reciente).

hPalCurrent

Identificador de la paleta actual.

fCapturingNow

Marca de captura. El valor de este miembro es TRUE cuando la captura está en curso.

dwReturn

Valores devueltos de error. Use este miembro si la aplicación no admite una función de devolución de llamada de error.

wNumVideoAllocated

Número de búferes de vídeo asignados. Este valor puede ser menor que el número especificado en el miembro wNumVideoRequested de la estructura CAPTUREPARMS .

wNumAudioAllocated

Número de búferes de audio asignados. Este valor puede ser menor que el número especificado en el miembro wNumAudioRequested de la estructura CAPTUREPARMS .

Comentarios

Dado que el estado de una ventana de captura cambia en respuesta a varios mensajes, una aplicación debe actualizar la información de esta estructura siempre que necesite habilitar elementos de menú, determinar el estado real de la ventana de captura o llamar al cuadro de diálogo formato de vídeo. Si la aplicación produce durante la captura de streaming, esta estructura devuelve el progreso de la captura en los miembros dwCurrentVideoFrame, dwCurrentVideoFramesDropped, dwCurrentWaveSamples y dwCurrentTimeElapsedMS . Use la macro WM_CAP_GET_STATUS mensaje o capGetStatus para actualizar el contenido de esta estructura.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	vfw.h

Consulte también

CAPTUREPARMS

Captura de vídeo

Estructuras de captura de vídeo

WM_CAP_GET_STATUS