GdiStartDocEMF function

The GdiStartDocEMF function performs initialization operations for an EMF-formatted print job.


BOOL GdiStartDocEMF(
  HANDLE   SpoolFileHandle,
  DOCINFOW *pDocInfo



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


Caller-supplied pointer to a DOCINFOW structure (described in the Microsoft Window SDK documentation).

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.


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

The function performs initializations that must take place before a print job's EMF records can be played. The function calls the spooler's StartDoc function (described in the Window SDK documentation), which in turn calls the printer driver's DrvStartDoc function.

The print processor must set the lpszOutput member of the DOCINFOW structure to the output file name contained in the PRINTPROCESSOROPENDATA structure, previously received by the OpenPrintProcessor function.

The print processor must set the lpszDocName member of the DOCINFOW structure to the document name pointer, previously received by the PrintDocumentOnPrintProcessor function.

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


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

See also