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 函數。

規格需求

需求 值
目標平台 Universal
標頭 winppi.h (包括 Winppi.h)
程式庫 Gdi32.Lib
Dll Gdi32.dll