Partager via


GdiGetBatchLimit, fonction (wingdi.h)

La fonction GdiGetBatchLimit retourne le nombre maximal d’appels de fonction pouvant être accumulés dans le lot actuel du thread appelant. Le système vide le lot actuel chaque fois que cette limite est dépassée.

Syntaxe

DWORD GdiGetBatchLimit();

Valeur de retour

Si la fonction réussit, la valeur de retour est la limite de lots.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

La limite de lots est définie à l’aide de la fonction GdiSetBatchLimit . La définition de la limite sur 1 désactive efficacement le traitement par lot.

Seules les fonctions de dessin GDI qui retournent des valeurs booléennes peuvent être traitées par lot ; appelle toutes les autres fonctions GDI qui vident immédiatement le lot actuel. Le dépassement de la limite de lots ou l’appel de la fonction GdiFlush vide également le lot actuel.

Lorsque le système effectue un traitement par lot d’un appel de fonction, la fonction retourne TRUE. La valeur de retour réelle de la fonction est signalée uniquement si GdiFlush est utilisé pour vider le lot.

Note La limite de lots est conservée séparément pour chaque thread. Pour désactiver complètement le traitement par lots, appelez GdiSetBatchLimit (1) pendant l’initialisation de chaque thread.
 

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête wingdi.h (inclure Windows.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi

GdiFlush

GdiSetBatchLimit

Fonctions de peinture et de dessin

Vue d’ensemble de la peinture et du dessin