GdiFlush Command

Purpose

The GdiFlush function flushes the GDI graphical output that has been cached (batch).

Syntax

GdiFlush

Description

GDI batches drawing functions to enhances drawing performance by minimizing the amount of time needed to call GDI drawing functions that return Boolean values. The system accumulates the parameters for calls to these functions in the current batch and then calls the functions when the batch is flushed by any of the following means:

  • Calling the GdiFlush function

  • Reaching or exceeding the batch limit set by the GdiSetBatchLimit API function

  • Filling the batching buffers.

  • Calling any GDI function that does not return a Boolean value.

    • An application should call GdiFlush before a thread goes away if there is a possibility that there are pending function calls in the graphics batch queue. The system does not execute such batched functions when a thread goes away.

    Remarks

    See Also

    {Created by Sjouke Hamstra; Last updated: 12/05/14 by James Gaite}