DrvStartPage

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.

BOOL
  DrvStartPage(
    IN SURFOBJ  *pso
    );

Parameters

pso

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.

Headers

Declared in winddi.h. Include winddi.h.

Comments

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.

See Also

DrvSendPage, EngWritePrinter