Функция GdiGetDevmodeForPage (winppi.h)

Функция GdiGetDevmodeForPage возвращает структуры DEVMODEW для указанной и предыдущей страниц задания печати.

Синтаксис

BOOL GdiGetDevmodeForPage(
  HANDLE    SpoolFileHandle,
  DWORD     dwPageNumber,
  PDEVMODEW *pCurrDM,
  PDEVMODEW *pLastDM
);

Параметры

SpoolFileHandle

Дескриптор файла очереди вызывающего объекта, полученный при предыдущем вызове GdiGetSpoolFileHandle.

dwPageNumber

Номер страницы, предоставленной вызывающим абонентом, для которой должно возвращаться содержимое DEVMODEW .

pCurrDM

Указанное вызывающим объектом расположение для получения указателя на структуру DEVMODE для страницы, указанной параметром dwPageNumber.

pLastDM

Указанное вызывающим объектом расположение для получения указателя на структуру DEVMODE для страницы, предшествующей странице, указанной параметром dwPageNumber.

Возвращаемое значение

Если операция выполнена успешно, функция возвращает значение TRUE. В противном случае возвращается значение FALSE.

Комментарии

Функция GdiGetDevmodeForPage экспортируется gdi32.dll для использования в функции PrintDocumentOnPrintProcessor обработчика печати.

Перед вызовом GdiPlayPageEMF для выполнения инструкций EMF страницы обработчик печати должен вызвать GdiGetDevmodeForPage, чтобы определить, совпадает ли структура DEVMODE, связанная с печатаемой страницей. Если две возвращенные структуры DEVMODE не идентичны, обработчик печати должен выполнить следующие действия по порядку, прежде чем вызывать GdiPlayPageEMF для страницы:

1. Вызовите GdiEndPageEMF.
2. Вызовите GdiResetDCEMF, указав DEVMODE, на который указывает pCurrDM.
3. Вызовите GdiStartPageEMF.

Дополнительные сведения см. в разделе Использование функций GDI в обработчиках печати.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	winppi.h (включая Winppi.h)
Библиотека	Gdi32.Lib
DLL	Gdi32.dll