Функция GdiSetBatchLimit определяет максимальное число вызовов функции, которые могут быть накоплены в текущем пакете вызывающего потока. Система очищает текущий пакет всякий раз, когда это ограничение превышается.
DWORD GdiSetBatchLimit( DWORD 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 | - | |
Замечания по платформе | Не имеется |