Metodo IPrintOemUIMXDC::AdjustImageCompression (prcomoem.h)

Articolo
02/26/2024

Il IPrintOemUIMXDC::AdjustImageCompression metodo consente a un driver della 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 in esecuzione una query.

cbDevMode

Dimensioni della struttura DEVMODE , inclusi i dati aggiunti.

pDevMode

Puntatore alla struttura DEVMODE contenente 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 di enumerazione 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 può completare l'operazione. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Commenti

Il IPrintOemUIMXDC::AdjustImageCompression metodo influisce sulle immagini JPEG e PNG generate da Microsoft XPS Document Converter (MXDC). Il IPrintOemUIMXDC::AdjustImageCompression metodo 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 di base, UnidrvUI.dll e PS5UI.dll, non modificano le impostazioni di compressione dell'immagine. Il plug-in, tuttavia, può modificare il valore fornito inizialmente al valore MXDC dal percorso di stampa GDI.

Il parametro pCompressionMode ha 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	Dimensioni medie e 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 del file più grandi

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 errore HRESULT appropriato, che causa l'esito negativo del processo di stampa corrente.

Requisiti

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)

Share via