Функция GdiGetBatchLimit (wingdi.h)

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

Синтаксис

DWORD GdiGetBatchLimit();

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

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

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

Комментарии

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

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

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

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

 

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll

См. также раздел

GdiFlush

GdiSetBatchLimit

Функции рисования и рисования

Общие сведения о рисовании и рисовании