WNDOBJ_cEnumStart, fonction (winddi.h)

Article
08/27/2023

La fonction WNDOBJ_cEnumStart est une fonction de rappel qui définit des paramètres pour l’énumération de rectangles dans la région visible d’une fenêtre.

Syntaxe

ENGAPI ULONG WNDOBJ_cEnumStart(
  WNDOBJ *pwo,
  ULONG  iType,
  ULONG  iDirection,
  ULONG  cLimit
);

Paramètres

pwo

Pointeur vers une structure WNDOBJ créée par un appel à EngCreateWnd.

iType

Spécifie le type de structures à retourner par WNDOBJ_bEnum. Ce paramètre peut être CT_RECTANGLES, ce qui signifie que la région doit être énumérée sous la forme d’une liste de rectangles.

iDirection

Détermine l’ordre dans lequel les rectangles sont retournés. Cet ordre peut être essentiel lorsqu’un DrvBitBlt qui se chevauche est exécuté sur la même surface. Si l’ordre n’est pas pertinent pour le pilote de périphérique, CD_ANY doit être spécifié. Cela permet à GDI d’optimiser son énumération pour les régions complexes. Ce paramètre peut être l’une des valeurs suivantes :

Valeur	Signification
CD_ANY	Toute commande pratique pour GDI.
CD_LEFTDOWN	De droite à gauche, de haut en bas.
CD_LEFTUP	De droite à gauche, de bas en haut.
CD_LEFTWARDS	De gauche à droite, la direction verticale n’est pas définie.
CD_RIGHTDOWN	De gauche à droite, de haut en bas.
CD_RIGHTUP	De gauche à droite, de bas en haut.
CD_UPWARDS	De bas en haut, la direction horizontale n’est pas définie.

cLimit

Indique le nombre d’objets que le pilote souhaite mettre en cache. Cela est uniquement utilisé pour décider quand arrêter le comptage des rectangles pendant que GDI calcule la valeur de retour pour cette fonction. Si cLimit est égal à zéro, le comptage n’est pas effectué.

Valeur retournée

La valeur de retour est le nombre d’objets qui seraient énumérés, à condition que cette valeur soit inférieure ou égale à cLimit. Si le nombre est supérieur à cLimit, la valeur de retour est 0xFFFFFFFF.

Remarques

L’énumération peut être redémarrée en appelant à nouveau cette fonction.

WNDOBJ_cEnumStart doit être appelée uniquement :

Dans le contexte de la fonction de rappel de pilote fournie à GDI dans la fonction EngCreateWnd , ou des fonctions DDI graphiques où un WNDOBJ est fourni.
Lorsque le thread appelant a le verrou de l’appareil pour s’assurer qu’aucune modification de la région du client ne se produit.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Universal
En-tête	winddi.h (inclure Winddi.h)
Bibliothèque	Win32k.lib
DLL	Win32k.sys

Voir aussi

Partager via