View source for SaveDCState

OS2_PM_DRV_ENABLE: SaveDCState requests the presentation driver to save all the information that it has about the device context.

==Syntax==
 SaveDCState(ulSubfunction, pParam1, pParam2)

==Parameters==
;ulSubfunction (ULONG) - input:07h.
;pParam1 (PULONG) - input:A pointer (pInstance) to the DC instance data.
;pParam2 (PLONG) - input:Not used.

==Return Code==
; rc (LONG) - returns: Return codes.
: The handling routine should return a LONG integer. Valid values are:
::0 Successful
::-1 Error

==Remarks==
The state of a DC might be saved multiple times in last-in-first-out (LIFO) order. The routine returns an error code if there is not enough memory available to save the state.

The handling routine must keep a count of the number of saved states.

[[RestoreDCState]] is related to SaveDCState.

==Sample Code==
<PRE>
#include <os2.h>

ULONG     ulSubfunction;  /* 07h. */
PULONG    pParam1;
PLONG     pParam2;        /* Not used. */
LONG      rc;             /* Return codes. */

rc = SaveDCState(ulSubfunction, pParam1, pParam2);
</PRE>

[[Category:Gre]]