WNDOBJ_cEnumStart

WNDOBJ_cEnumStart

ULONG WNDOBJ_cEnumStart(

WNDOBJ *pwo,
ULONG iType,
ULONG iDirection,
ULONG cLimit
);

WNDOBJ_cEnumStart is a callback function that sets parameters for enumeration of rectangles in the visible region of a window.

Parameters

pwo

Points to a WNDOBJ structure created by a call to EngCreateWnd.

iType

Specifies the type of structures to be returned by WNDOBJ_bEnum. This parameter can be CT_RECTANGLES, meaning that the region is to be enumerated as a list of rectangles.

iDirection

Determines the order in which the rectangles are returned. This order can be essential when an overlapping DrvBitBlt is being performed on the same surface. If the order is not relevant to the device driver, then CD_ANY should be specified. This allows GDI to optimize its enumeration for complex regions. This parameter can be one of the following values:

Value	Meaning
CD_RIGHTDOWN	Left to right, top to bottom.
CD_LEFTDOWN	Right to left, top to bottom.
CD_RIGHTUP	Left to right, bottom to top.
CD_LEFTUP	Right to left, bottom to top.
CD_LEFTWARDS	Left to right, vertical direction is not defined.
CD_UPWARDS	Bottom to top, horizontal direction is not defined.
CD_ANY	Any order convenient for GDI.

cLimit

An indication of how many objects the driver is interested in caching. This is only used to decide when to stop counting rectangles while GDI is calculating the return value for this function. If cLimit is zero, counting is not done.

Return Value

The return value is a count of the number of objects that would be enumerated, provided this value is less than or equal to cLimit. If the count is greater than cLimit, the return value is 0xFFFFFFFF.

Comments

Enumeration can be restarted by calling this function again.

WNDOBJ_cEnumStart should be called only:

·In the context of the driver callback function supplied to GDI in the EngCreateWnd function, or the DDI functions where a WNDOBJ is given.

·When the calling thread has the device lock to ensure that no client region changes occur.