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

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

Синтаксис

HRESULT AdjustDPI(
  HANDLE         hPrinter,
  DWORD          cbDevMode,
  const PDEVMODE pDevMode,
  DWORD          cbOEMDM,
  const PVOID    pOEMDM,
  PLONG          pDPI
);

Параметры

hPrinter

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

cbDevMode

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

pDevMode

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

cbOEMDM

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

pOEMDM

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

pDPI

Указатель на текущее разрешение в точках на дюйм (DPI) с учетом квадратных пикселей. Если этот параметр настроен, его возвращаемое значение должно быть положительным целым числом.

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

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

Комментарии

Параметр pDPI имеет значение IN OUT. Все остальные параметры для этой функции являются только входными.

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

Требования

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