GdiGetDevmodeForPage 函数 (winppi.h)

  • 项目

GdiGetDevmodeForPage 函数返回打印作业的指定页和上一页的 DEVMODEW 结构。

语法

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

参数

SpoolFileHandle

调用方提供的假脱机文件句柄，由先前调用 GdiGetSpoolFileHandle 获取。

dwPageNumber

要为其返回 DEVMODEW 内容的页面的调用方提供的编号。

pCurrDM

调用方提供的位置，用于接收指向 dwPageNumber 指定页面的 DEVMODE 结构的指针。

pLastDM

调用方提供的位置，用于接收指向 dwPageNumber 指定页面前一页的 DEVMODE 结构的指针。

返回值

如果操作成功，函数将返回 TRUE。 否则返回 FALSE。

注解

GdiGetDevmodeForPage 函数由 gdi32.dll 导出，以便在打印处理器的 PrintDocumentOnPrintProcessor 函数中使用。

在调用 GdiPlayPageEMF 以执行页面的 EMF 指令之前，打印处理器必须调用 GdiGetDevmodeForPage ，以确定与要打印的页面关联的 DEVMODE 结构是否与打印的最后一页结构相同。 如果返回的两个 DEVMODE 结构不相同，打印处理器必须按顺序执行以下步骤，然后再为页面调用 GdiPlayPageEMF ：

  1. 调用 GdiEndPageEMF。
  2. 调用 GdiResetDCEMF，指定 pCurrDM 指向的 DEVMODE。
  3. 调用 GdiStartPageEMF。
有关其他信息，请参阅 在打印处理器中使用 GDI 函数。

要求

要求 值
目标平台 通用
标头 winppi.h (包括 Winppi.h)
Library Gdi32.Lib
DLL Gdi32.dll