## Presentation Device Driver Reference for OS/2

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

### GreSaveRegion

Select an item:

    Syntax
    Parameters
    Returns
    Remarks
    Glossary

Simulation support:

This function is simulated by a handling routine in the graphics engine.

Description

GreSaveRegion is called during SaveDC and OpenDC to allow the region handling routines to save their local data structures. When a new DC is created, GreSaveRegion is called with a save level of 1 to initialize its local data. A Save with a count of one more than the current save level generates intervening levels. A negative save value is invalid. When initializing a new DC, a valid visible region handle must be created.

This function can be hooked by the presentation driver.

    #define INCL_GRE_CLIP

    #include <os2.h>

    HDC      hdc;        /*  Device context handle. */

    LONG     cSave;      /*  DC save level. This must not be a negative value. */

    PVOID    pInstance;  /*  Pointer to instance data. */

    ULONG    lFunction;  /*  High-order WORD=flags; low-order WORD=NGreSaveRegion. */

    BOOL     fSuccess;   /*  Return codes. */

    fSuccess = GreSaveRegion(hdc, cSave, pInstance,

                 lFunction);