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

Статья
08/07/2023

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

Синтаксис

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

Параметры

pdevobj

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

dwAdjustType

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

Flag	Значение
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. То есть цепочка подключаемых модулей вызывается до тех пор, пока не будет найден первый подключаемый модуль, способный обрабатывать корректировку.

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