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.
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 |