## Presentation Device Driver Reference for OS/2

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

### GreRestoreDC Parameter - idDC

idDC (LONG) - input DC state identifier.

Identifies the DC state to be restored. The values with which this parameter may be passed are as follows:

A negative value indicates the number of device contexts that must be popped OFF the stack to access the required DC. A -1 indicates that the most recently saved DC must be restored.

When this parameter is passed as a positive value (>0) and a corresponding DC does not exist, an error is returned. The current DC is not modified.

When passed as a negative value and there are insufficient entries on the stack, an error is raised. The current DC is not modified.

When the value passed corresponds to a saved DC, all entries on the stack up to the one indicated are discarded. Any clip regions selected into the discarded DCs are destroyed.

A value of 1 resets the DC stack. All entries are removed from the stack.

A value of 0 raises an error and the DC is not modified.