DrvStartPage function (winddi.h)

  • Article

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

[in] 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.

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

Requirement Value
Target Platform Desktop
Header winddi.h (include Winddi.h)

See also

DrvSendPage

EngWritePrinter