WNDOBJ

typedef struct _WNDOBJ{

    CLIPOBJ  coClient;

    PVOID    pvConsumer;

    RECTL    rclClient;

} WNDOBJ, *PWNDOBJ;

The WNDOBJ structure allows the driver to keep track of the position, size, and visible client region changes of a window. The visible client region can be enumerated by calling the WNDOBJ_cEnumStart and WNDOBJ_bEnum functions.

Members

coClient

A CLIPOBJ that describes the region of the window. If iDComplexity is DC_RECT and the left edge in rclBounds is greater than or equal to the right edge, or the top edge is greater than or equal to the bottom edge, the client region is invisible.

pvConsumer

A driver-defined value for identifying this particular WNDOBJ. This value can be set by calling the WNDOBJ_vSetConsumer function.

rclClient

A lower-right exclusive rectangle of the client area of the window in screen coordinates.

Comments

A driver can associate its own data with a WNDOBJ by calling the WNDOBJ_vSetConsumer function.

As an accelerator, the driver can access public members of the WNDOBJ. These public members are guaranteed to remain unchanged only in the context of the driver callback routine supplied to GDI in the EngCreateWnd function, or the functions where a WNDOBJ is given.

See Also

CLIPOBJ, WNDOBJ_bEnum, WNDOBJ_cEnumStart, WNDOBJ_vSetConsumer