Metodo IPrintOemUIMXDC::AdjustImageCompression (prcomoem.h)

Articolo
02/07/2025

Il metodo IPrintOemUIMXDC::AdjustImageCompression consente a un driver di pipeline di filtro XPS di usare UnidrvUI.dll o PS5UI.dll per supportare la configurazione del livello di compressione per immagini JPEG o PNG.

Sintassi

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

Parametri

hPrinter

Handle per la stampante attualmente sottoposta a query.

cbDevMode

Dimensioni della struttura DEVMODE, inclusi i dati accodati.

pDevMode

Puntatore alla struttura DEVMODE che contiene le impostazioni correnti del dispositivo.

cbOEMDM

Numero di byte nella sezione fornita dal fornitore della struttura DEVMODE.

pOEMDM

Puntatore ai dati contenuti nella parte fornitore della struttura DEVMODE a cui pDevMode punta.

pCompressionMode

Puntatore al livello di compressione corrente. pCompressionMode è un tipo enum specificato in Mxdc.h.

Valore restituito

AdjustImageCompression restituisce S_OK se il metodo ha esito positivo. In caso contrario, questo metodo deve restituire E_NOTIMPL se il plug-in non supporta il metodo o un valore di errore appropriato se il plug-in non è in grado di completare l'operazione. Per altre informazioni, vedere la sezione Osservazioni seguente.

Osservazioni

Il metodo IPrintOemUIMXDC::AdjustImageCompression influisce sulle immagini JPEG e PNG generate da Microsoft XPS Document Converter (MXDC). Il metodo IPrintOemUIMXDC::AdjustImageCompression non influisce sulle immagini JPEG e PNG inviate direttamente dalle applicazioni a GDI tramite il meccanismo pass-through dell'immagine JPEG/PNG GDI (BMF_JPEG, BMF_PNG).

I driver principali, UnidrvUI.dll e PS5UI.dll, non modificano le impostazioni di compressione delle immagini. Il plug-in, tuttavia, può modificare il valore inizialmente fornito a MXDC dal percorso di stampa GDI.

Il parametro pCompressionMode include uno dei valori predefiniti seguenti.

Tipo ENUM	Valore	Significato
MXDC_IMAGETYPE_JPEGHIGH_COMPRESSION	1	Qualità minima e dimensioni del file più piccole
MXDC_IMAGETYPE_JPEGMEDIUM_COMPRESSION	2	Media qualità e dimensioni medie dei file
MXDC_IMAGETYPE_JPEGLOW_COMPRESSION	3	Alta qualità e dimensioni di file di grandi dimensioni
MXDC_IMAGETYPE_PNG	4	Massima qualità e dimensioni massime dei file

Il parametro pCompressionMode è IN OUT. Tutti gli altri parametri per questa funzione sono solo input.

Se il plug-in non è in grado di completare l'operazione, deve restituire un HRESULT di errore appropriato, causando l'esito negativo del processo di stampa corrente.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile con Windows Vista e versioni successive di Unidrvui.dll e Ps5ui.dll, ridistribuibili. Questo metodo è disponibile anche per i driver XPSDrv in Microsoft Windows XP se è stato installato XPS Essentials Pack.
piattaforma di destinazione	Desktop
intestazione	prcomoem.h (include Prcomoem.h)

Condividi tramite