GdiGetDevmodeForPage, fonction (winppi.h)

La fonction GdiGetDevmodeForPage retourne des structures DEVMODEW pour les pages spécifiées et précédentes d’un travail d’impression.

Syntaxe

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

Paramètres

SpoolFileHandle

Handle de fichier de pool fourni par l’appelant, obtenu par un appel précédent à GdiGetSpoolFileHandle.

dwPageNumber

Numéro de la page fournie par l’appelant pour laquelle le contenu DEVMODEW doit être retourné.

pCurrDM

Emplacement fourni par l’appelant pour recevoir un pointeur vers une structure DEVMODE pour la page spécifiée par dwPageNumber.

pLastDM

Emplacement fourni par l’appelant pour recevoir un pointeur vers une structure DEVMODE pour la page antérieure à celle spécifiée par dwPageNumber.

Valeur retournée

Si l’opération réussit, la fonction retourne TRUE. Sinon, elle retourne FALSE.

Remarques

La fonction GdiGetDevmodeForPage est exportée par gdi32.dll pour une utilisation dans la fonction PrintDocumentOnPrintProcessor d’un processeur d’impression.

Avant d’appeler GdiPlayPageEMF pour exécuter les instructions EMF d’une page, un processeur d’impression doit appeler GdiGetDevmodeForPage pour déterminer si la structure DEVMODE associée à la page à imprimer est identique à celle de la dernière page imprimée. Si les deux structures DEVMODE retournées ne sont pas identiques, le processeur d’impression doit effectuer les étapes suivantes, dans l’ordre, avant d’appeler GdiPlayPageEMF pour la page :

1. Appelez GdiEndPageEMF.
2. Appelez GdiResetDCEMF, en spécifiant le DEVMODE pointé par pCurrDM.
3. Appelez GdiStartPageEMF.

Pour plus d’informations, consultez Utilisation de fonctions GDI dans les processeurs d’impression.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	winppi.h (inclure Winppi.h)
Bibliothèque	Gdi32.Lib
DLL	Gdi32.dll