DrvQuerySpoolType

LONG DrvQuerySpoolType(

IN DHPDEV dhpdev,
IN OUT LPWSTR pwszDatatype
);

DrvQuerySpoolType retrieves the data type that the driver will use to spool a print job.

Parameters

dhpdev

Handle to this instance of the driver.

pwszDatatype

As input, pwszDatatype is a pointer to a null-terminated string specifying the data type that the spooler should use to record the print job. The input string is obtained from an application call to the Win32 StartDoc function; this string is empty if StartDoc has not been called. As output, pwszDatatype is a pointer to the data type that this driver will use to write the job to the spooler via EngWritePrinter. The data type returned by the driver overrides the type requested by the application.

Return Value

DrvQuerySpoolType returns TRUE upon success; it returns FALSE if it fails.

Comments

DrvQuerySpoolType allows a driver to specify the data type that it will use to write a print job. If a driver does not export DrvQuerySpoolType, and an application does not otherwise request a certain data type, the default data type of RAW is used to spool the job.

The size of the buffer to which pwszDatatype points is 80 characters.

Printer drivers can optionally implement this function.