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

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

Синтаксис

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

Параметры

hPrinter

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

cbDevMode

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

pDevMode

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

cbOEMDM

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

pOEMDM

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

pCompressionMode

Указатель на текущий уровень сжатия. pCompressionMode — это тип перечисления, указанный в mxdc.h.

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

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

Комментарии

Метод IPrintOemUIMXDC::AdjustImageCompression влияет на изображения JPEG и PNG, созданные Microsoft XPS Document Converter (MXDC). Метод IPrintOemUIMXDC::AdjustImageCompression не влияет на изображения JPEG и PNG, которые непосредственно отправляются приложениями в GDI через механизм сквозной передачи изображений GDI JPEG/PNG (BMF_JPEG, BMF_PNG).

Основные драйверы, UnidrvUI.dll и PS5UI.dll, не изменяют параметры сжатия изображений. Однако подключаемый модуль может изменить значение, которое изначально предоставляется MXDC путем печати GDI.

Параметр pCompressionMode имеет одно из следующих предопределенных значений.

Тип ENUM	Значение	Значение
MXDC_IMAGETYPE_JPEGHIGH_COMPRESSION	1	Минимальное качество и минимальный размер файла
MXDC_IMAGETYPE_JPEGMEDIUM_COMPRESSION	2	Среднее качество и средний размер файла
MXDC_IMAGETYPE_JPEGLOW_COMPRESSION	3	Высокое качество и большой размер файла
MXDC_IMAGETYPE_PNG	4	Наивысшее качество и максимальный размер файла

 

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

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

Требования

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