BeginBufferedPaint 函数 (uxtheme.h)

开始缓冲绘制操作。

语法

HPAINTBUFFER BeginBufferedPaint(
        HDC             hdcTarget,
        const RECT      *prcTarget,
        BP_BUFFERFORMAT dwFormat,
  [in]  BP_PAINTPARAMS  *pPaintParams,
  [out] HDC             *phdc
);

参数

hdcTarget

类型： HDC

将绘制缓冲区的目标 DC 的句柄。

prcTarget

类型： const RECT*

指向 RECT 结构的指针，该结构指定要在其中绘制的目标 DC 的区域。

dwFormat

类型： BP_BUFFERFORMAT

指定缓冲区格式的 BP_BUFFERFORMAT 枚举的成员。

[in] pPaintParams

类型： BP_PAINTPARAMS*

指向定义绘制操作参数 的BP_PAINTPARAMS 结构的指针。 此值可以为 NULL。

[out] phdc

类型： HDC*

当此函数返回时， 指向新设备上下文的句柄。

返回值

类型： HPAINTBUFFER

缓冲的绘制上下文的句柄。 如果此函数失败，则返回值为 NULL， phdc 为 NULL。 要获得更多的错误信息，请调用 GetLastError。

调用 EndBufferedPaint 时释放返回的句柄。

在调用 BeginBufferedPaint 之前，应用程序应在调用线程上调用 BufferedPaintInit，并在线程终止之前调用 BufferedPaintUnInit。 调用 BufferedPaintInit 失败可能会导致性能下降，因为每个缓冲的绘制操作的内部数据都会被初始化和销毁。

要求

最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	uxtheme.h
DLL	UxTheme.dll