DrvStartPage function

The DrvStartPage function is called by GDI when it is ready to start sending the contents of a physical page to the driver for rendering.

Syntax


BOOL DrvStartPage(
  _In_ SURFOBJ *pso
);

Parameters

pso [in]

Caller-supplied pointer to a SURFOBJ structure.

Return value

If the operation succeeds, the function should return TRUE. Otherwise, it should call the Win32 SetLastError function to set an error code, and then return FALSE.

Remarks

A printer graphics DLL must provide a DrvStartPage function. The function is called before each physical page of a print job is rendered. (A physical page can contain one or more document pages.)

Typically the function is used for sending control sequences to printer hardware, before a page is printed, by calling GDI's EngWritePrinter function. The function can also perform internal, page-specific initialization operations for the printer graphics DLL.

Requirements

Target platform

Header

Winddi.h (include Winddi.h)

See also

DrvSendPage
EngWritePrinter

 

 

Send comments about this topic to Microsoft

Show: