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

Статья
02/07/2025

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

Синтаксис

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

Параметры

SpoolFileHandle

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

dwPageNumber

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

pCurrDM

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

pLastDM

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

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

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

Замечания

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

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

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

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

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	winppi.h (include Winppi.h)
библиотеки	Gdi32.Lib
DLL	Gdi32.dll

Поделиться через