18 сент. 2010 г.

GdiFlush

Функция GdiFlush сохраняет на диск текущий пакет вызывающего потока.

BOOL GdiFlush(VOID);

Параметры:
Эта функция не имеет параметров.
Возвращаемые значения:
Если все функции GDI в текущем пакете обрабатываются корректно, возвращается ненулевое значение.
Если не все функции GDI в текущем пакете обрабатываются корректно, возвращается ноль, указывая на то, что по крайней мере одна функция возвратила ошибку.
Замечания:
Пакетирование расширяет эффективность вывода, уменьшая количество времени, необходимое для вызова функция GDI, возвращающих значение булевого типа (BOOL). Система накапливает параметры вызовов этих функций в текущем пакете и сбрасывает его на диск, вызывая функции GDI при любом из следующих условий:
  • вызов функции GdiFlush;
  • достижение или превышение пакетного предела, установленного функцией GdiSetBatchLimit;
  • заполнение буферов пакетирования;
  • вызов любой функции GDI, не возвращающей значение булевого типа.
Возвращаемое значение для GdiFlush действительно только для функций в пакете, которые находятся в нем во время вызова GdiFlush. Ошибки, которые происходят во время сбрасывания пакета, не поступают ни в какой отчет.
Функция GdiGetBatchLimit возвращает ограничение пакета.
Учтите, что ограничение пакета имеет разное значение для каждого потока. Для польного отключения пакетирования, вызовите GdiSetBatchLimit(1) при инициализации каждого потока.
Смотрите также:
в 18:20