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