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

Weitere Informationen

CLIPOBJ

CLIPOBJ_cEnumStart

ENUMRECTS