Funzione GdiStartDocEMF (winppi.h)

  • Articolo

La funzione GdiStartDocEMF esegue operazioni di inizializzazione per un processo di stampa formattato da EMF.

Sintassi

BOOL GdiStartDocEMF(
  HANDLE   SpoolFileHandle,
  DOCINFOW *pDocInfo
);

Parametri

SpoolFileHandle

Handle di file spool fornito dal chiamante, ottenuto da una chiamata precedente a GdiGetSpoolFileHandle.

pDocInfo

Puntatore fornito dal chiamante a una struttura DOCINFOW (descritta nella documentazione di Microsoft Window SDK).

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce TRUE. In caso contrario, la funzione restituisce FALSE e un codice di errore può essere ottenuto chiamando GetLastError.

Commenti

La funzione GdiStartDocEMF viene esportata da gdi32.dll per l'uso all'interno della funzione PrintDocumentOnPrintProcessor di un processore di stampa.

La funzione esegue inizializzazioni che devono essere eseguite prima che sia possibile riprodurre i record EMF di un processo di stampa. La funzione chiama la funzione StartDoc del spooler (descritta nella documentazione di Window SDK), che a sua volta chiama la funzione DrvStartDoc del driver della stampante.

Il processore di stampa deve impostare il membro lpszOutput della struttura DOCINFOW sul nome del file di output contenuto nella struttura PRINTPROCESSOROPENDATA , precedentemente ricevuto dalla funzione OpenPrintProcessor .

Il processore di stampa deve impostare il membro lpszDocName della struttura DOCINFOW sul puntatore del nome del documento, ricevuto in precedenza dalla funzione PrintDocumentOnPrintProcessor .

Per altre informazioni, vedere Uso di funzioni GDI nei processori di stampa.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Intestazione winppi.h (include Winppi.h)
Libreria Gdi32.Lib
DLL Gdi32.dll

Vedi anche

GdiEndDocEMF