ResetDC

The ResetDC function updates the given printer or plotter device context, based on the information in the specified structure.

HDC ResetDC(
  HDC hdc,                   // handle to device context
  CONST DEVMODE *lpInitData  // pointer to device context information
);
 

Parameters

hdc

Handle to the device context to update.

lpInitData

Pointer to a DEVMODE structure containing information about the new device context.

Return Values

If the function succeeds, the return value is the handle of the original device context.

If the function fails, the return value is NULL.

Windows NT: To get extended error information, call GetLastError.

Remarks

An application will typically use the ResetDC function when a window receives a WM_DEVMODECHANGE message. ResetDC can also be used to change the paper orientation or paper bins while printing a document.

The ResetDC function cannot be used to change the driver name, device name, or the output port. When the user changes the port connection or device name, the application must delete the original device context and create a new device context with the new information.

An application can pass an information device context to the ResetDC function. In that situation, ResetDC will always return a printer device context.

ICM: The color profile of the device context specified by the hdc parameter will be reset based on the information contained in the lpInitData member of the DEVMODE structure.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in wingdi.h.
  Import Library: Use gdi32.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Device Contexts Overview, Device Context Functions, DeviceCapabilities, DEVMODE, Escape