Funzione DrvStartDoc (winddi.h)
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) |