Функция GdiGetBatchLimit


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

Синтаксис

DWORD GdiGetBatchLimit(VOID);

Параметры

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

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

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

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

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

Замечания

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

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

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

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

Смотри также

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

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

К 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