Метод IPrintOemPS2::GetPDEVAdjustment (prcomoem.h)

Статья
02/07/2025

Метод IPrintOemPS2::GetPDEVAdjustment позволяет подключаемым модулем переопределять определенные параметры PDEV.

Синтаксис

HRESULT GetPDEVAdjustment(
        PDEVOBJ  pdevobj,
        DWORD    dwAdjustType,
        PVOID    pBuf,
        DWORD    cbBuffer,
  [out] OUT BOOL *pbAdjustmentDone
);

Параметры

pdevobj

Указатель на структуру DEVOBJ.

dwAdjustType

Указывает тип запрашиваемой корректировки. В настоящее время поддерживаются следующие флаги:

Флаг	Значение
PDEV_ADJUST_PAPER_MARGIN_TYPE	Настройте параметр поля бумаги, сообщаемого в PDEV. См. структуру PDEV_ADJUST_PAPER_MARGIN.
PDEV_HOSTFONT_ENABLED_TYPE	Включите или отключите функцию поддержки Hostfont. См. структуру PDEV_HOSTFONT_ENABLED.
PDEV_USE_TRUE_COLOR_TYPE	Включите или отключите цветовые выходные данные для монохромных и цветных принтеров. См. структуру PDEV_USE_TRUE_COLOR.

pBuf

Указатель на структуру, содержащую запланированные параметры, используемые при отсутствии изменений. Эти структуры перечислены в предыдущей таблице. Подключаемый модуль может перезаписать параметры в соответствующей структуре.

cbBuffer

Задает размер структуры в байтах, на которую указывает pBuf.

[out] pbAdjustmentDone

Указатель на расположение памяти, которое подключаемый модуль задает для TRUE при изменении значения в буфере. Это может использоваться драйвером для оптимизации.

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

Метод IPrintOemPS2::GetPDEVAdjustment должен возвращать S_OK, если он распознает тип корректировки, и S_FALSE, если это не так. Если метод завершается ошибкой, он должен возвращать E_FAIL. Цепочка подключаемых модулей вызывается до тех пор, пока не возвращается код сбоя S_OK, отличный от E_NOTIMPL. То есть цепочка подключаемых модулей вызывается до тех пор, пока не будет найден первый подключаемый модуль, способный обрабатывать корректировку.

Замечания

Эта функция доступна в Windows XP и более поздних версиях.

В настоящее время драйвер Pscript5 вызывает IPrintOemPS2::GetPDEVAdjustment для настройки параметра поля бумаги, как сообщается в PDEV, для включения или отключения функции Hostfont или включения или отключения выходных данных цвета PostScript.