Método IPrintOemUIMXDC::AdjustImageCompression (prcomoem.h)

El IPrintOemUIMXDC::AdjustImageCompression método permite que un controlador de canalización de filtro XPS use UnidrvUI.dll o PS5UI.dll para admitir la configuración del nivel de compresión para imágenes JPEG o PNG.

Sintaxis

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

Parámetros

hPrinter

Identificador de la impresora que se está consultando actualmente.

cbDevMode

Tamaño de la estructura DEVMODE , incluidos los datos anexados.

pDevMode

Puntero a la estructura DEVMODE que contiene la configuración actual del dispositivo.

cbOEMDM

Número de bytes de la sección proporcionada por el proveedor de la estructura DEVMODE.

pOEMDM

Puntero a los datos contenidos en la parte del proveedor de la estructura DEVMODE a la que apunta pDevMode .

pCompressionMode

Puntero al nivel de compresión actual. pCompressionMode es un tipo de enumeración especificado en Mxdc.h.

Valor devuelto

AdjustImageCompression devuelve S_OK si el método se realiza correctamente. De lo contrario, este método debe devolver E_NOTIMPL si el complemento no admite el método o cualquier valor de error adecuado si el complemento no puede completar la operación. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Comentarios

El IPrintOemUIMXDC::AdjustImageCompression método afecta a imágenes JPEG y PNG generadas por Microsoft XPS Document Converter (MXDC). El IPrintOemUIMXDC::AdjustImageCompression método no afecta a las imágenes JPEG y PNG enviadas directamente por las aplicaciones a GDI a través del mecanismo de paso a través de imágenes JPEG/PNG de GDI (BMF_JPEG, BMF_PNG).

Los controladores principales, UnidrvUI.dll y PS5UI.dll, no modifican la configuración de compresión de imágenes. Sin embargo, el complemento puede cambiar el valor proporcionado inicialmente al MXDC por la ruta de impresión de GDI.

El parámetro pCompressionMode tiene uno de los siguientes valores predefinidos.

Tipo ENUM	Valor	Significado
MXDC_IMAGETYPE_JPEGHIGH_COMPRESSION	1	Menor calidad y tamaño de archivo más pequeño
MXDC_IMAGETYPE_JPEGMEDIUM_COMPRESSION	2	Calidad media y tamaño medio de archivo
MXDC_IMAGETYPE_JPEGLOW_COMPRESSION	3	Tamaño de archivo grande y de alta calidad
MXDC_IMAGETYPE_PNG	4	Mayor calidad y tamaño de archivo más grande

 

El parámetro pCompressionMode es IN OUT. Todos los demás parámetros de esta función son solo de entrada.

Si el complemento no puede completar la operación, debe devolver un error HRESULT adecuado, lo que hace que se produzca un error en el trabajo de impresión actual.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible con Windows Vista y versiones posteriores de Unidrvui.dll y Ps5ui.dll, que son redistribuibles. Este método también está disponible para los controladores XPSDrv en Microsoft Windows XP si ha instalado XPS Essentials Pack.
Plataforma de destino	Escritorio
Encabezado	prcomoem.h (include Prcomoem.h)