通过

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）
库 Gdi32.Lib
DLL Gdi32.dll