Funzione GdiGetDevmodeForPage (winppi.h)

La funzione GdiGetDevmodeForPage restituisce le strutture DEVMODEW per le pagine specificate e precedenti di un processo di stampa.

Sintassi

BOOL GdiGetDevmodeForPage(
  HANDLE    SpoolFileHandle,
  DWORD     dwPageNumber,
  PDEVMODEW *pCurrDM,
  PDEVMODEW *pLastDM
);

Parametri

SpoolFileHandle

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

dwPageNumber

Numero specificato dal chiamante della pagina per il quale devono essere restituiti i contenuti DEVMODEW .

pCurrDM

Percorso fornito dal chiamante per ricevere un puntatore a una struttura DEVMODE per la pagina specificata da dwPageNumber.

pLastDM

Percorso fornito dal chiamante per ricevere un puntatore a una struttura DEVMODE per la pagina precedente a quella specificata da dwPageNumber.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce TRUE. In caso contrario, restituisce FALSE.

Commenti

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

Prima di chiamare GdiPlayPageEMF per eseguire le istruzioni EMF di una pagina, un processore di stampa deve chiamare GdiGetDevmodeForPage per determinare se la struttura DEVMODE associata alla pagina da stampare è uguale a quella dell'ultima pagina stampata. Se le due strutture DEVMODE restituite non sono identiche, il processore di stampa deve eseguire i passaggi seguenti, prima di chiamare GdiPlayPageEMF per la pagina:

1. Chiamare GdiEndPageEMF.
2. Chiamare GdiResetDCEMF, specificando devMODE a cui fa riferimento pCurrDM.
3. Chiamare GdiStartPageEMF.

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