icDrawBegin 函数 (vfw.h)
ICDrawBegin 函数初始化呈现器并为绘图准备绘图目标。
语法
DWORD VFWAPIV ICDrawBegin(
HIC hic,
DWORD dwFlags,
HPALETTE hpal,
HWND hwnd,
HDC hdc,
int xDst,
int yDst,
int dxDst,
int dyDst,
LPBITMAPINFOHEADER lpbi,
int xSrc,
int ySrc,
int dxSrc,
int dySrc,
DWORD dwRate,
DWORD dwScale
);
参数
hic
要使用的解压缩器的句柄。
dwFlags
解压缩标志。 定义了以下值。
| 值 | 含义 |
|---|---|
| ICDRAW_ANIMATE | 应用程序可以对调色板进行动画处理。 |
| ICDRAW_CONTINUE | 绘图是上一帧的延续。 |
| ICDRAW_FULLSCREEN | 在全屏上绘制解压缩的数据。 |
| ICDRAW_HDC | 将解压缩的数据绘制到窗口或 DC。 |
| ICDRAW_MEMORYDC | DC 处于屏幕外。 |
| ICDRAW_QUERY | 确定解压缩器是否可以解压缩数据。 驱动程序不会解压缩数据。 |
| ICDRAW_UPDATING | 当前帧正在更新而不是播放。 |
hpal
用于绘制的调色板的句柄。
hwnd
用于绘制的窗口的句柄。
hdc
用于绘图的 DC。
xDst
目标矩形右上角的 x 坐标。
yDst
目标矩形右上角的 y 坐标。
dxDst
目标矩形的宽度。
dyDst
目标矩形的高度。
lpbi
指向 BITMAPINFOHEADER 结构的指针，该结构包含要解压缩的输入数据的格式。
xSrc
源矩形右上角的 x 坐标。
ySrc
源矩形右上角的 y 坐标。
dxSrc
源矩形的宽度。
dySrc
源矩形的高度。
dwRate
帧速率分子。 帧速率（以帧/秒为单位）是通过将 dwRate 除以 dwScale 获得的。
dwScale
帧速率分母。 帧速率（以帧/秒为单位）是通过将 dwRate 除以 dwScale 获得的。
返回值
如果呈现器可以解压缩数据或ICERR_UNSUPPORTED否则返回 ICERR_OK 。
注解
ICDRAW_HDC标志和ICDRAW_FULLSCREEN标志互斥。 如果应用程序在 dwFlags 中设置ICDRAW_HDC标志，则解压缩器将使用 hwnd、hdc 以及定义目标矩形的参数， (xDst、yDst、dxDst 和 dyDst) 。 应用程序应将这些参数设置为目标矩形的大小。 指定相对于当前窗口或 DC 的目标矩形值。
如果应用程序在 dwFlags 中设置ICDRAW_FULLSCREEN标志，则不使用 hwnd 和 hdc 参数，应将其设置为 NULL。 此外，不使用目标矩形，其参数可以设置为零。
源矩形相对于整个视频帧。 将拉伸或缩小源矩形指定的视频帧部分以适应目标矩形。
dwRate 和 dwScale 参数指定解压缩率。 为 dwRate 指定的整数值除以为 dwScale 指定的整数值可定义帧速率（以帧/秒为单位）。 当呈现器负责播放期间的计时帧时，该值由它使用。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | vfw.h |
| Library | Vfw32.lib |
| DLL | Msvfw32.dll |