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

Статья
08/07/2023

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

Синтаксис

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

Параметры

pdevobj

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

dwAdjustType

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

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

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