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.