fonction CLIPOBJ_bEnum (winddi.h)
La fonction CLIPOBJ_bEnum énumère un lot de rectangles d’une région de clip spécifiée ; un appel antérieur à CLIPOBJ_cEnumStart détermine l’ordre d’énumération.
Syntaxe
ENGAPI BOOL CLIPOBJ_bEnum(
[in] CLIPOBJ *pco,
[in] ULONG cj,
[out] ULONG *pul
);
Paramètres
[in] pco
Pointeur vers une structure CLIPOBJ décrivant la région de clip à énumérer.
[in] cj
Spécifie la taille, en octets, de la mémoire tampon pointée vers pv.
[out] pul
Pointeur vers la mémoire tampon qui recevra des données sur la région de clip dans une structure ENUMRECTS .
Valeur retournée
La valeur de retour est TRUE si le pilote doit appeler à nouveau cette fonction pour plus de données d’énumération, ou FALSE si l’énumération est terminée. Il est possible pour CLIPOBJ_bEnum de retourner TRUE avec le nombre de rectangles de découpage égal à zéro. Dans ce cas, le pilote doit appeler à nouveau CLIPOBJ_bEnum sans effectuer d’action.
Remarques
Voici une structure de boucle possible pour appeler cette fonction :
do {
bMore = CLIPOBJ_bEnum(pco, sizeof(buffer), &buffer.c);
for (i = 0; i < buffer.c; i++) {
.
.
.
}
} while (bMore);
Le nombre d’objets écrits dans la mémoire tampon est écrit dans la mémoire tampon elle-même.
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 |