EngCreateClip

CLIPOBJ *EngCreateClip(VOID)

EngCreateClip creates a CLIPOBJ structure that the driver uses in callbacks. This CLIPOBJ allows GDI to directly access banked frame buffers. The structure must be initialized by the driver so that CLIPOBJ.iDComplexity is set to DC_TRIVIAL or DC_RECT. If CLIPOBJ.iDComplexity is set to DC_RECT, the driver can set rclBounds to be the extent of the frame buffer bank. The driver must delete this CLIPOBJ using EngDeleteClip.

Return Value

The return value is a pointer to the newly-created CLIPOBJ if the function succeeds. Otherwise, it is null.