21 сент. 2010 г.

GdiGetBatchLimit

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