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

Статья
02/07/2025

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

Синтаксис

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

Параметры

pdevobj

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

dwAdjustType

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

Флаг	Значение
PDEV_ADJUST_GRAPHICS_RESOLUTION_TYPE	Настройте параметр разрешения графики, сообщающийся в структуре PDEV. Дополнительные сведения см. в структуре PDEV_ADJUST_GRAPHICS RESOLUTION.
PDEV_IMAGEABLE_ORIGIN_AREA_TYPE	Настройте область источника, доступную для изображения, которая сообщается в структуре PDEV. Дополнительные сведения см. в PDEV_ADJUST_IMAGEABLE_ORIGIN_AREA структуре.
PDEV_ADJUST_PHYSICAL_PAPER_SIZE_TYPE	Настройте размер физической бумаги, сообщаемой в структуре PDEV. Дополнительные сведения см. в PDEV_ADJUST_PAPER_PHYSICAL_SIZE структуре.

pBuf

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

cbBuffer

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

[out] pbAdjustmentDone

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

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

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

Замечания

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

В настоящее время драйвер Unidrv вызывает IPrintOemUni3::GetPDEVAdjustment для настройки параметра разрешения графики, как сообщается в PDEV, для настройки области источника для изображения или настройки физического размера бумаги.