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 関数は、印刷プロセッサの PrintDocumentOnPrintProcessor 関数内で使用するために、gdi32.dll によってエクスポートされます。

ページの EMF 命令を実行するために GdiPlayPageEMF を呼び出す前に、印刷プロセッサは GdiGetDevmodeForPage を呼び出して、印刷するページに関連付けられている DEVMODE 構造体が最後に印刷されたページと同じかどうかを判断する必要があります。 返された 2 つの DEVMODE 構造体が同一でない場合、印刷プロセッサは、ページに 対して GdiPlayPageEMF を呼び出す前に、次の手順を順番に実行する必要があります。

1. GdiEndPageEMF を呼び出します。
2. pCurrDM が指す DEVMODE を指定して、GdiResetDCEMF を呼び出します。
3. GdiStartPageEMF を呼び出します。

詳細については、「 印刷プロセッサでの GDI 関数の使用」を参照してください。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	winppi.h (Winppi.h を含む)
Library	Gdi32.Lib
[DLL]	Gdi32.dll