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
#include <os2.h> ULONG ulSubfunction; /* 07h. */ PULONG pParam1; PLONG pParam2; /* Not used. */ LONG rc; /* Return codes. */ rc = SaveDCState(ulSubfunction, pParam1, pParam2);