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 を呼び出す前に、次の手順を順番に実行する必要があります。
- GdiEndPageEMF を呼び出します。
- pCurrDM が指す DEVMODE を指定して、GdiResetDCEMF を呼び出します。
- GdiStartPageEMF を呼び出します。
要件
要件 | 値 |
---|---|
対象プラットフォーム | ユニバーサル |
Header | winppi.h (Winppi.h を含む) |
Library | Gdi32.Lib |
[DLL] | Gdi32.dll |