На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

GdiFlush



The GdiFlush function flushes the calling thread's current batch.

BOOL GdiFlush(VOID)


Parameters

This function has no parameters.

Return Values

If all functions in the current batch succeed, the return value is nonzero.
If not all functions in the current batch succeed, the return value is zero, indicating that at least one function returned an error.

Remarks

Batching enhances drawing performance by minimizing the amount of time needed to call GDI drawing functions that return Boolean values. The system accumulates the parameters for calls to these functions in the current batch and then calls the functions when the batch is flushed by any of the following means:

· Calling the GdiFlush function
· Reaching or exceeding the batch limit set by the GdiSetBatchLimit function
· Filling the batching buffers
· Calling any GDI function that does not return a Boolean value



The return value for GdiFlush applies only to the functions in the batch at the time GdiFlush is called. Errors that occur when the batch is flushed by any other means are never reported.
The GdiGetBatchLimit function returns the batch limit.
Note that the batch limit is maintained for each thread separately. In order to completely disable batching, call GdiSetBatchLimit(1) during the initialization of each thread.
An application should call GdiFlush before a thread goes away if there is a possibility that there are pending function calls in the graphics batch queue. The operating system does not execute such batched functions when a thread goes away.

A multithreaded application that serializes access to GDI objects with a mutex must ensure flushing the GDI batch queue by calling GdiFlush as each thread releases ownership of the GDI object. This prevents collisions of the GDI objects (device contexts, metafiles, and so on).

See Also

GdiGetBatchLimit, GdiSetBatchLimit


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

GdiFlush



Функция GdiFlush сбрасывает вызов резьбы текущего пакета.

BOOL GdiFlush(ПУСТОТА)


Параметры

Эта функция не имеет параметры.

Обратные Величины

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

Замечания

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

Вызывая функцию GdiFlush
Достигая или превышая пакетный предел был установлен функцией GdiSetBatchLimit Заполняя группирующие буферы Вызывая любую функцию GDI, что не возвращает Логическую величину



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

multithreaded Приложение, которое издает сериями доступ к объектам GDI с mutex должно гарантировать сбрасывая пакетную очередь GDI вызывая GdiFlush как каждая резьба выпускает собственность на объект GDI. Это предохраняет столкновения объектов GDI (контексты устройства, метафайлов, и так далее).

Смотри Также

GdiGetBatchLimit, GdiSetBatchLimit


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz