Edit

Share via

GdiResetDCEMF function (winppi.h)

  • Article

The GdiResetDCEMF function resets a printer's device context during playback of a spooled EMF print job.

Syntax

BOOL GdiResetDCEMF(
  HANDLE    SpoolFileHandle,
  PDEVMODEW pCurrDM
);

Parameters

SpoolFileHandle

Caller-supplied spool file handle, obtained by a previous call to GdiGetSpoolFileHandle.

pCurrDM

Caller-supplied pointer to a DEVMODEW structure, obtained by a previous call to GdiGetDevmodeForPage.

Return value

If the operation succeeds, the function returns TRUE. Otherwise the function returns FALSE.

Remarks

The GdiResetDCEMF function is exported by gdi32.dll for use within a print processor's PrintDocumentOnPrintProcessor function.

Print processors must call GdiResetDCEMF whenever it is necessary to reset the printer's device context. The function must be called whenever the GdiGetDevmodeForPage function indicates that the current document page's DEVMODEW structure is not identical to that of the previous document page.

For additional information, see Using GDI Functions in Print Processors.

Requirements

Requirement Value
Target Platform Universal
Header winppi.h (include Winppi.h)
Library Gdi32.Lib
DLL Gdi32.dll