capSTATUS 结构 (vfw.h)

CAPSTATUS 结构定义捕获窗口的当前状态。

语法

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;

成员

uiImageWidth

图像宽度（以像素为单位）。

uiImageHeight

图像高度（以像素为单位）

fLiveWindow

活动窗口标志。 如果窗口使用预览方法显示视频，则此成员的值为 TRUE 。

fOverlayWindow

覆盖窗口标志。 如果窗口使用硬件覆盖显示视频，则此成员的值为 TRUE 。

fScale

输入缩放标志。 如果窗口在使用预览显示视频时将输入视频缩放到工作区，则此成员的值为 TRUE 。 使用覆盖显示视频时，此参数无效。

ptScroll

显示在窗口工作区左上角的像素的 x 和 y 偏移量。

fUsingDefaultPalette

默认调色板标志。 如果捕获驱动程序使用其默认调色板，则此成员的值为 TRUE 。

fAudioHardware

音频硬件标志。 如果系统安装了波形音频硬件，则此成员的值为 TRUE 。

fCapFileExists

捕获文件标志。 如果已生成有效的捕获文件，则此成员的值为 TRUE 。

dwCurrentVideoFrame

在当前 (或最近) 流式处理捕获期间处理的帧数。 此计数包括丢弃的帧。

dwCurrentVideoFramesDropped

当前 (或最近) 流式处理捕获期间丢弃的帧数。 当捕获速率超过帧可以保存到文件的速率时，将发生丢弃的帧。 在这种情况下，捕获驱动程序没有可用于存储数据的缓冲区。 删除帧不会影响同步，因为显示上一帧代替放置的帧。

dwCurrentWaveSamples

在当前 (或最近) 流式处理捕获期间处理的波形音频样本数。

dwCurrentTimeElapsedMS

自当前 (开始或最近) 流式处理捕获以来的时间（以毫秒为单位）。

hPalCurrent

当前调色板的句柄。

fCapturingNow

正在捕获标志。 捕获正在进行时，此成员的值为 TRUE 。

dwReturn

错误返回值。 如果应用程序不支持错误回调函数，请使用此成员。

wNumVideoAllocated

分配的视频缓冲区数。 此值可能小于 CAPTUREPARMS 结构的 wNumVideoRequested 成员中指定的数字。

wNumAudioAllocated

分配的音频缓冲区数。 此值可能小于 CAPTUREPARMS 结构的 wNumAudioRequested 成员中指定的数字。

注解

由于捕获窗口的状态会随着各种消息的响应而更改，因此应用程序应在需要启用菜单项、确定捕获窗口的实际状态或调用视频格式对话框时更新此结构中的信息。 如果应用程序在流式捕获期间生成，此结构将返回 dwCurrentVideoFrame、 dwCurrentVideoFramesDropped、 dwCurrentWaveSamples 和 dwCurrentTimeElapsedMS 成员中的捕获进度。 使用 WM_CAP_GET_STATUS 消息或 capGetStatus 宏更新此结构的内容。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	vfw.h

另请参阅

CAPTUREPARMS

视频捕获

视频捕获结构

WM_CAP_GET_STATUS