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

另请参阅

视频压缩函数

视频压缩管理器