GdiGetDevmodeForPage-Funktion (winppi.h)

Die GdiGetDevmodeForPage-Funktion gibt DEVMODEW-Strukturen für die angegebenen und vorherigen Seiten eines Druckauftrags zurück.

Syntax

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

Parameter

SpoolFileHandle

Vom Aufrufer bereitgestelltes Spooldateihandle, das durch einen vorherigen Aufruf von GdiGetSpoolFileHandle abgerufen wurde.

dwPageNumber

Vom Aufrufer bereitgestellte Nummer der Seite, für die DEVMODEW-Inhalte zurückgegeben werden sollen.

pCurrDM

Vom Aufrufer bereitgestellter Speicherort, um einen Zeiger auf eine DEVMODE-Struktur für die durch dwPageNumber angegebene Seite zu empfangen.

pLastDM

Vom Aufrufer bereitgestellter Speicherort, um einen Zeiger auf eine DEVMODE-Struktur für die Seite vor der durch dwPageNumber angegebenen Zu empfangen.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion TRUE zurück. Andernfalls wird FALSE zurückgegeben.

Hinweise

Die GdiGetDevmodeForPage-Funktion wird von gdi32.dll zur Verwendung in der PrintDocumentOnPrintProcessor-Funktion eines Druckprozessors exportiert.

Bevor GdiPlayPageEMF aufgerufen wird, um die EMF-Anweisungen einer Seite auszuführen, muss ein Druckprozessor GdiGetDevmodeForPage aufrufen, um festzustellen, ob die devMODE-Struktur, die der zu druckenden Seite zugeordnet ist, der der zuletzt gedruckten Seite entspricht. Wenn die beiden zurückgegebenen DEVMODE-Strukturen nicht identisch sind, muss der Druckprozessor die folgenden Schritte ausführen, bevor GdiPlayPageEMF für die Seite aufgerufen wird:

1. Rufen Sie GdiEndPageEMF auf.
2. Rufen Sie GdiResetDCEMF auf, und geben Sie den DEVMODE-Wert an, auf den pCurrDM verweist.
3. Rufen Sie GdiStartPageEMF auf.

Weitere Informationen finden Sie unter Verwenden von GDI-Funktionen in Druckprozessoren.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
Header	winppi.h (winppi.h einschließen)
Bibliothek	Gdi32.Lib
DLL	Gdi32.dll