GdiStartDocEMF - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// winppi.h

BOOL GdiStartDocEMF(
  HANDLE   SpoolFileHandle,
  DOCINFOW *pDocInfo
);
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-winppi-gdistartdocemf)

GdiStartDocEMF function

Description

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

Parameters

SpoolFileHandle

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

pDocInfo

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.

Remarks

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.

See also

GdiEndDocEMF