勇芳软件工作室.汉化:  Painting and Drawing > Painting and Drawing Functions >

GdiSetBatchLimit

Previous pageReturn to chapter overviewNext page

描述

 

GdiSetBatchLimit函数设置调用线程当前批处理中可累积的最大函数调用次数。超出此限制时,系统将刷新当前批次。

 

C++ 语法

 

DWORD GdiSetBatchLimit(

__in DWORD dwLimit

);

 

PowerBASIC 语法

 

FUNCTION GdiSetBatchLimit ( _

BYVAL dwLimit AS DWORD _

) AS DWORD

 

参数

 

dwLimit

 

[in]指定要设置的批量限制。值0设置默认限制。值为1将禁用批处理。

 

返回值

 

如果函数成功,则返回值为上一个批量限制。

 

如果函数失败,返回值为零。

 

备注

 

只有返回布尔值的GDI绘图函数才能在当前批中累积;调用任何其他GDI函数立即刷新当前批处理。超过批量限制或调用GdiFlush功能也会刷新当前批次。

 

当系统累积函数调用时,函数返回TRUE,表示它在批处理中。当系统刷新当前批次并且第二次执行该函数时,返回值为TRUE或FALSE,具体取决于功能是否成功。仅当GdiFlush用于刷新批次时,才会报告此第二个返回值。

 

注意 单独维护每个线程的批量限制。为了完全禁用批处理,在每个线程的初始化期间调用GdiSetBatchLimit(1)。

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)