CLIPOBJ_bEnum-Funktion (winddi.h)
Die CLIPOBJ_bEnum-Funktion listet einen Batch von Rechtecken aus einem angegebenen Clipbereich auf. ein vorheriger Aufruf von CLIPOBJ_cEnumStart bestimmt die Reihenfolge der Enumeration.
Syntax
ENGAPI BOOL CLIPOBJ_bEnum(
[in] CLIPOBJ *pco,
[in] ULONG cj,
[out] ULONG *pul
);
Parameter
[in] pco
Zeiger auf eine CLIPOBJ-Struktur , die den Clipbereich beschreibt, der aufgelistet werden soll.
[in] cj
Gibt die Größe des Puffers in Bytes an, auf den von pv verwiesen wird.
[out] pul
Zeiger auf den Puffer, der Daten zum Clipbereich in einer ENUMRECTS-Struktur empfängt .
Rückgabewert
Der Rückgabewert ist TRUE , wenn der Treiber diese Funktion für weitere Enumerationsdaten erneut aufrufen muss, oder FALSE , wenn die Enumeration abgeschlossen ist. Es ist möglich, dass CLIPOBJ_bEnumTRUE zurückgeben, wobei die Anzahl der ausschneidenden Rechtecke gleich 0 ist. In solchen Fällen sollte der Fahrer CLIPOBJ_bEnum erneut aufrufen, ohne maßnahmen zu ergreifen.
Hinweise
Es folgt eine mögliche Schleifenstruktur zum Aufrufen dieser Funktion:
do {
bMore = CLIPOBJ_bEnum(pco, sizeof(buffer), &buffer.c);
for (i = 0; i < buffer.c; i++) {
.
.
.
}
} while (bMore);
Die Anzahl der in den Puffer geschriebenen Objekte wird in den Puffer selbst geschrieben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Universell |
| Header | winddi.h (einschließlich Winddi.h) |
| Bibliothek | Win32k.lib |
| DLL | Win32k.sys |