CLIPOBJ_bEnum

BOOL CLIPOBJ_bEnum(

IN CLIPOBJ *pco,
IN ULONG cj,
OUT ULONG *pv
);

CLIPOBJ_bEnum enumerates a batch of rectangles from a specified clip region. A prior call to CLIPOBJ_cEnumStart determines the order of enumeration.

Parameters

pco

Points to a CLIPOBJ structure describing the clipping region that is to be enumerated.

cj

Specifies the size, in bytes, of the buffer pointed to by pv.

pv

Points to the buffer that will receive data about the clip region in an ENUMRECTS structure.

Return Value

The return value is TRUE if the driver must call this function again for more enumeration data, or FALSE if the enumeration is complete. It is possible for CLIPOBJ_bEnum to return TRUE with the number of clipping rectangles equal to zero. In such cases, the driver should call CLIPOBJ_bEnum again without taking any action.

Comments

A possible loop structure for calling this function follows:

do {
    bMore = CLIPOBJ_bEnum(pco, sizeof(buffer), &buffer.c);
    for (i = 0; i < buffer.c; i++) {
        .
        .
        .
    }
} while (bMore);
 

The count of objects written to the buffer is written to the buffer itself.

See Also

CLIPOBJ, CLIPOBJ_cEnumStart, ENUMRECTS