Прочитать на английском

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


Метод IPrintOemUIMXDC::AdjustImageableArea (prcomoem.h)

Метод IPrintOemUIMXDC::AdjustImageableArea позволяет драйверу конвейера фильтра XPS использовать UnidrvUI.dll или PS5UI.dll для поддержки конфигурации области печати, включая ориентацию и направление поворота.

Синтаксис

HRESULT AdjustImageableArea(
  HANDLE         hPrinter,
  DWORD          cbDevMode,
  const PDEVMODE pDevMode,
  DWORD          cbOEMDM,
  const PVOID    pOEMDM,
  PRECTL         prclImageableArea
);

Параметры

hPrinter

Дескриптор принтера, который в настоящее время запрашивается.

cbDevMode

Размер структуры DEVMODE в байтах, включая добавленные данные.

pDevMode

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

cbOEMDM

Количество байтов в разделе, предоставленном поставщиком, структуры DEVMODE.

pOEMDM

Указатель на данные, содержащиеся в части поставщика структуры DEVMODE, на которую pDevMode указывает.

prclImageableArea

Указатель на структуру RECTL, содержащую печатную область. Этот параметр заполняется UnidrvUI.dll или PS5UI.dll данными из соответствующего GPD или PPD, прежде чем параметр передается в подключаемый модуль. Подключаемый модуль может обновить эти данные перед возвратом.

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

AdjustImageableArea возвращает S_OK, если этот метод выполнен успешно. В противном случае этот метод должен возвращать E_NOTIMPL, если подключаемый модуль не поддерживает метод, или любое соответствующее значение сбоя, если подключаемый модуль не может завершить операцию. Дополнительные сведения см. в следующем разделе "Примечания".

Замечания

Параметр prclImageableArea имеет значение IN OUT. Все остальные параметры этого метода являются только входными.

Если подключаемый модуль не может завершить операцию, он должен вернуть соответствующее значение HRESULT сбоя, что приведет к сбою текущего задания печати.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Доступные в Windows Vista и более поздних версиях Unidrvui.dll и Ps5ui.dll, которые являются распространяемыми. Этот метод также доступен для драйверов XPSDrv в Microsoft Windows XP, если установлен пакет XPS Essentials.
целевая платформа Настольный
заголовка prcomoem.h (include Prcomoem.h)

См. также

IPrintOemUIMXDC

RECTL