## Presentation Device Driver Reference for OS/2

[prev][next][parent][TOC]

### GreNotifyClipChange - Parameters

hdc (HDC) - input Device context handle.

prclBound (PRECTL) - input Pointer to a rectangle that bounds the new clip region in screen coordinates.

This rectangle is inclusive on the left and bottom borders, and exclusive on the right and top borders.

cRect (ULONG) - input Number of rectangles in the new clip region as returned by GetClipRects.

idClipPath (ULONG) - input Current ClipPath ID.

For display devices, when idClipPath is passed as NCC_CLEANDC, the handling routine should clear the HDC_IS_DIRTY flag and return Successful. See VisRegionNotify and GreDeviceInvalidateVisRegion.

Presentation drivers for other devices ignore this parameter.

pInstance (PVOID) - input Pointer to instance data.

lFunction (ULONG) - input High-order WORD=flags; low-order WORD= NGreNotifyClipChange.

rc (BOOL) - returns Return Code.

On completion, the handling routine must return a BOOLEAN value to indicate success or an error.

TRUE Successful
FALSE Error

Note: Presentation drivers that do not cache the clip rectangles should return TRUE, if there are no errors.

Possible Errors Detected: When an error is detected, the handling routine must call WinSetErrorInfo to post the condition. Error codes for conditions that the handling routine is expected to check include:

PMERR_DEV_FUNC_NOT_INSTALLED
PMERR_HDC_BUSY
PMERR_INV_COORDINATE
PMERR_INV_HDC
PMERR_INV_RECT
PMERR_INV_REGION_CONTROL

Refer to the "Error Explanations" section in the Presentation Manager Programming Reference for further explanation.