The GdiEndPageEMF function ends EMF playback operations for a physical page of an EMF-formatted print job.
BOOL GdiEndPageEMF( HANDLE SpoolFileHandle, DWORD dwOptimization );
Caller-supplied spool file handle, obtained by a previous call to GdiGetSpoolFileHandle.
Caller-supplied flags. The following flag is defined:
Enable color optimization. For more information, see Remarks.
If the operation succeeds, the function returns TRUE. Otherwise the function returns FALSE, and an error code can be obtained by calling GetLastError.
The GdiEndPageEMF function is exported by gdi32.dll for use within a print processor's PrintDocumentOnPrintProcessor function.
The GdiEndPageEMF function ends the processing of a physical page and causes it to be ejected from the printer. A print processor should call GdiEndPageEMF at the following times:
- After the appropriate number of document pages have been placed on the physical page by making calls to GdiPlayPageEMF. Note that GdiPlayPageEMF does not actually print on the device context, but instead prepares a data structure that describes the text and graphics that are to be printed on the physical page(s). The text and graphics are printed to the device context when GdiEndPageEMF is called.
- Whenever a call to GdiGetDevmodeForPage indicates a document page's DEVMODEW structure is different from the previous page's DEVMODE structure.
If you are creating a Unidrv rendering plug-in to generate color watermarks, be advised that color optimization causes color watermarks to be printed in black and white when they are printed on black-and-white documents. To ensure that color watermarks print correctly with color and black-and-white documents, disable color optimization.
The color optimization controlled by the dwOptimization parameter can also be controlled by setting the dwColorOptimization member of the ATTRIBUTE_INFO_2 or ATTRIBUTE_INFO_3 structures. This optimization also can be controlled by the Unidrv *ChangeColorModeOnDoc? color attribute (see Color Attributes).
For additional information, see Using GDI Functions in Print Processors.
|Header||winppi.h (include Winppi.h)|