DrvSplStartDoc

HANDLE DrvSplStartDoc(

HANDLE hPrinter,
DWORD  JobId
);

DrvSplStartDoc starts the identified print job.

Parameters

hPrinter

Handle that identifies the printer on which the job is to be printed.

JobId

Specifies the ID number of the job to be printed.

Return Value

DrvSplStartDoc returns a per-job instance handle upon success; it returns zero if it fails.

Comments

The handle returned by DrvSplStartDoc is typically a pointer to a block of memory allocated by the user-mode printer driver for the instance data associated with the job identified by JobId. The user-mode printer driver should save hPrinter and JobId because they are not provided in any subsequent DrvSplXxx calls.

The user-mode printer driver should take any steps necessary to protect itself in the event that multiple jobs are printed simultaneously.

DrvSplStartDoc must be implemented if you do write a user-mode printer driver.

See Also

DrvSplEndDoc