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

GdiFlush

Previous pageReturn to chapter overviewNext page

描述

 

GdiFlush函数刷新调用线程的当前批处理。

 

C++ 语法

 

BOOL GdiFlush(void);

 

PowerBASIC 语法

 

FUNCTION GdiFlush () AS LONG

 

参数

 

此函数无参数。

 

返回值

 

如果当前批处理中的所有功能成功,则返回值不为零。

 

如果当前批处理中的所有函数都不成功,返回值为零,表示至少有一个函数返回错误。

 

备注

 

批处理通过最小化调用返回布尔值的GDI绘图函数所需的时间来增强绘图性能。系统累积在当前批次中调用这些函数的参数,然后通过以下任一方式冲洗批次时调用这些函数:

 

·调用GdiFlush功能。
·达到或超过GdiSetBatchLimit功能设置的批量限制。
·填充批处理缓冲区。
·调用不返回布尔值的任何GDI函数。

 

GdiFlush的返回值仅适用于调用GdiFlush时批处理中的功能。批量冲洗时出现的任何其他方式的错误都不会报告。

 

GdiGetBatchLimit函数返回批量限制。

 

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

 

如果在图形批处理队列中存在待处理的函数调用的可能性,应用程序应该在线程消失之前调用GdiFlush.当线程消失时,系统不执行这样的批处理功能。

 

使用互斥体对GDI对象进行序列化的多线程应用程序必须确保通过调用GdiFlush来刷新GDI批处理队列,因为每个线程释放GDI对象的所有权。这可以防止GDI对象的冲突(设备上下文,图元文件等)。

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)