Метод 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 (включая Prcomoem.h) |