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

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

Синтаксис

DWORD GdiSetBatchLimit(
  [in] DWORD dw
);

Параметры

[in] dw

Указывает устанавливаемую пакетную квоту. Значение 0 задает ограничение по умолчанию. Значение 1 отключает пакетную обработку.

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

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

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

Комментарии

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

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

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

 

Требования

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

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

GdiFlush

GdiGetBatchLimit

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

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