Funzione DrvStartDoc (winddi.h)

  • Articolo

La funzione DrvStartDoc viene chiamata da GDI quando è pronto per avviare l'invio di un documento al driver per il rendering.

Sintassi

BOOL DrvStartDoc(
  [in] SURFOBJ *pso,
  [in] LPWSTR  pwszDocName,
  [in] DWORD   dwJobId
);

Parametri

[in] pso

Puntatore fornito dal chiamante a una struttura SURFOBJ .

[in] pwszDocName

Puntatore fornito dal chiamante a una stringa Unicode con terminazione NULL specificando il nome del documento da stampare.

[in] dwJobId

Numero di processo di stampa fornito dal chiamante. Questo valore viene restituito a GDI dal spooler in una chiamata a StartDocPrinter.

Valore restituito

Se l'operazione ha esito positivo, la funzione deve restituire TRUE. In caso contrario, deve chiamare la funzione SetLastError Win32 per impostare un codice di errore e quindi restituire FALSE.

Commenti

Una DLL grafica della stampante deve fornire una funzione DrvStartDoc . In genere la funzione viene usata per inviare sequenze di controllo all'hardware della stampante, prima che venga stampato un documento, chiamando la funzione EngWritePrinter di GDI. La funzione può anche eseguire operazioni di inizializzazione interne e specifiche del documento per la DLL grafica della stampante.

La funzione DrvStartDoc viene chiamata all'inizio di un processo di stampa e ogni volta che un'applicazione (ad esempio un processore di stampa) chiama ResetDC (vedere DrvResetPDEV). Quando la chiamata a DrvStartDoc proviene da ResetDC, il parametro pwszDocName è impostato su NULL e il parametro dwJobId è impostato su zero. Quando la chiamata proviene da un'applicazione, questi parametri vengono impostati rispettivamente sul nome del documento e sul numero di processo di stampa.

Poiché non è presente una chiamata separata alla DLL grafica della stampante quando viene avviato un processo di stampa, la funzione DrvStartDoc deve anche inviare sequenze di controllo alla stampante per inizializzare il processo, se richiesto dalla stampante. In altre parole, esiste un documento per processo.

Requisiti

   
Piattaforma di destinazione Desktop
Intestazione winddi.h (include Winddi.h)

Vedi anche

DrvEndDoc

DrvResetPDEV

EngWritePrinter