GdiStartPageEMF function (winppi.h)

The GdiStartPageEMF function performs initialization operations for a physical page of an EMF-formatted print job.

Syntax

BOOL GdiStartPageEMF(
  HANDLE SpoolFileHandle
);

Parameters

SpoolFileHandle

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

Return value

If the operation succeeds, the function returns TRUE. Otherwise the function returns FALSE, and an error code can be obtained by calling GetLastError.

Remarks

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

A print processor must call the GdiStartPageEMF function each time a new physical page is to be created. It can then call GdiPlayPageEMF for each document page that is to be placed on the physical 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

See also

GdiEndPageEMF