Функция GdiGetBatchLimit

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

Синтаксис

Параметры

У этой функции нет параметров.

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

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

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

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

Замечания

Предел пакета устанавливается при помощи использования функции GdiSetBatchLimit. Установка предела в 1 фактически запрещает пакетирование.

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

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

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

Смотри также

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