GdiStartDocEMF function (winppi.h)
The GdiStartDocEMF function performs initialization operations for an EMF-formatted print job.
Syntax
BOOL GdiStartDocEMF(
HANDLE SpoolFileHandle,
DOCINFOW *pDocInfo
);
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.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Universal |
| Header | winppi.h (include Winppi.h) |
| Library | Gdi32.Lib |
| DLL | Gdi32.dll |