DCI Helper Function

extern DCIRVAL WINAPI DCISetSrcDestClip(LPDCIOFFSCREEN pdci, LPRECT srcrc, LPRECT destrc, LPRGNDATA prd );

This function bounds the cliplist passed down in the region data with a rectangle that is the intersection between the passed down destination rectangle and the bounding rectangle inside the region data. This function then calls DCISetDestination with the specified source and destination rectangles. If the call is successful, DCISetClipList is called with the newly generated region data and DCISetSrcDestClip returns with the error code from DCISetClipList. If DCISetDestination fails, this function returns with the error code.

It is the DCI client's responsibility to ensure the region data specified is valid. This region data may be the result of a previous call to the WinWatchGetClipList or the GetWindowRegionData function.

RETURNS

Returns DCIRVAL.

COMMENTS

If DCISetDestination or DCISetClipList fails, DCIMAN will not restore LPRGNDATA to its original value. The DCI client will be responsible for dealing with this new LPRGNDATA.