GdiSetBatchLimit

  DWORD GdiSetBatchLimit(cLimit)    
  DWORD cLimit;    

The GdiSetBatchLimit function controls the maximum number of GDI drawing calls that can be accumulated before any drawing occurs.

Parameters

cLimit

The maximum number of calls that can be batched. For the default use zero.

Return Value

The return value specifies the previous batch-limit value. It is zero if an error occurred. Use the GetLastError function to obtain extended error information.

Comments

The only calls that can be batched are GDI drawing calls that return BOOL's. If a call is batched it will return TRUE. Any non batchable call will flush the current batch. Setting cLimit to 1 will effectively remove batching all together. You can force the batch to be flushed at any time with GdiFlush.

See Also

GdiFlush, GdiGetBatchLimit