Функция GdiSetBatchLimit

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

Синтакис

DWORD GdiSetBatchLimit(
  DWORD dwLimit   // лимит пакета
);

Параметры

dwLimit

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

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

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

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

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

Замечания

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

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

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

Смотри также

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

Размещение и совместимость GdiSetBatchLimit

К Windows Vista Да
л Windows XP Да
и Windows 2000 Professional Да
е Windows NT Workstation Да версии 3.1 и выше
н Windows Me Да
т Windows 98 Да
  Windows 95 Да
С Windows Server 2008 Да
е Windows Server 2003 Да
р Windows 2000 Server Да
в Windows NT Server Да версии 3.1 и выше
е
р
Используемая библиотека Gdi32.lib
Используемая DLL -
Заголовочный файл
- объявлено в Wingdi.h
- включено в Windows.h
Unicode -
Замечания по платформе Не имеется

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz