fonction WNDOBJ_bEnum (winddi.h)
La fonction WNDOBJ_bEnum obtient un lot de rectangles à partir de la région visible d’une fenêtre.
Syntaxe
ENGAPI BOOL WNDOBJ_bEnum(
WNDOBJ *pwo,
ULONG cj,
ULONG *pul
);
Paramètres
pwo
Pointeur vers une structure WNDOBJ créée par un appel à EngCreateWnd.
cj
Spécifie la taille, en octets, de la mémoire tampon pointée vers pul. GDI n’écrit pas au-delà de cette limite.
pul
Pointeur vers la mémoire tampon dans laquelle une structure du formulaire suivant doit être écrite. Dans cette structure, c est un nombre de rectangles retournés, et arcl est un tableau de rectangles :
typedef struct _ENUMRECTS{
ULONG c;
RECTL arcl[]
} ENUMRECTS;
Valeur retournée
La valeur de retour est TRUE s’il y a plus de données à énumérer et si le pilote doit répéter l’appel. Elle est FALSE si l’énumération est terminée.
Remarques
L’ordre d’énumération est déterminé par l’appel à WNDOBJ_cEnumStart.
Une structure de boucle possible pour appeler cette fonction suit.
do {
bMore = WNDOBJ_bEnum(pwo, sizeof(buffer), &buffer.c);
for (i = 0; i < buffer.c; i++) {
// Process the data
}
} while (bMore);
WNDOBJ_bEnum doit être appelé uniquement par la fonction de rappel fournie à GDI par la fonction EngCreateWnd ou par les fonctions DDI graphiques qui reçoivent un WNDOBJ.
Configuration requise
| 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 |