Функция GdiSetBatchLimit

Функция GdiSetBatchLimit определяет максимальное число вызовов функции, которые могут быть накоплены в текущем пакете вызывающего потока. Система очищает текущий пакет всякий раз, когда это ограничение превышается.

Синтакис

Параметры

[in] Определяет лимит пакета, который будет установлен. Значение 0 устанавливает лимит по умолчанию. Значение 1 отключает пакетирование.

Возвращаемые значения

Если функция завершается успешно, возвращаемое значение - предыдущий лимит пакета.

Если функция завершается ошибкой, возвращаемое значение - нуль.

Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

Только функции рисования GDI, которые возвращают Булевы значения, могут быть накоплены в текущем пакете;  текущий пакет от вызовов любых других функций GDI немедленно очищается. Превышение лимита пакета или вызов функции GdiFlush также очищает текущий пакет.

Когда система накапливает вызовы функции, функция возвращает значение TRUE, чтобы указать, что она находится в пакете. Когда система очищает текущий пакет и выполняет функцию во второй раз, тогда возвращаемое значение - или TRUE или FALSE, в зависимости от того, завершается ли работа функции успешно. В этом втором возвращаемом значении сообщается только то, что используется функция GdiFlush, чтобы очистить пакет.

Обратите внимание! на то, что лимит пакета поддерживается для каждого потока отдельно. Для того, чтобы полностью отключить пакетирование, вызовите функцию GdiSetBatchLimit (1) в ходе инициализация каждого потока.

Смотри также

Обзор Окрашивание и рисование, Функции окрашивания и рисования, GdiFlush, GdiGetBatchLimit