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。

要求