Fonction GdiSetBatchLimit (wingdi.h)

La fonction GdiSetBatchLimit définit le nombre maximal d’appels de fonction qui peuvent être cumulé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 GdiSetBatchLimit(
  [in] DWORD dw
);

Paramètres

[in] dw

Spécifie la limite de lots à définir. La valeur 0 définit la limite par défaut. La valeur 1 désactive le traitement par lots.

Valeur retournée

Si la fonction réussit, la valeur de retour correspond à la limite de lot précédente.

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

Remarques

Seules les fonctions de dessin GDI qui retournent des valeurs booléennes peuvent être accumulées dans le lot actuel ; appelle toutes les autres fonctions GDI immédiatement vider 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 accumule un appel de fonction, la fonction retourne TRUE pour indiquer qu’elle se trouve dans le lot. Lorsque le système vide le lot actuel et exécute la fonction pour la deuxième fois, la valeur de retour est TRUE ou FALSE, selon que la fonction réussit ou non. Cette deuxième valeur de retour 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

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

GdiGetBatchLimit

Fonctions de peinture et de dessin

Vue d’ensemble de la peinture et du dessin