IPrintOemUIMXDC ::AdjustImageCompression, méthode (prcomoem.h)

Article
02/07/2025

La méthode IPrintOemUIMXDC::AdjustImageCompression permet à un pilote de pipeline de filtre XPS d’utiliser UnidrvUI.dll ou PS5UI.dll pour prendre en charge la configuration du niveau de compression pour les images JPEG ou PNG.

Syntaxe

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

Paramètres

hPrinter

Handle vers l’imprimante en cours de requête.

cbDevMode

Taille de la structure DEVMODE, y compris les données ajoutées.

pDevMode

Pointeur vers la structure DEVMODE qui contient les paramètres actuels de l’appareil.

cbOEMDM

Nombre d’octets dans la section fournie par le fournisseur de la structure DEVMODE.

pOEMDM

Pointeur vers les données contenues dans la partie fournisseur de la structure DEVMODE vers laquelle pDevMode pointe.

pCompressionMode

Pointeur vers le niveau de compression actuel. pCompressionMode est un type d’énumération spécifié dans Mxdc.h.

Valeur de retour

AdjustImageCompression retourne S_OK si la méthode réussit. Sinon, cette méthode doit retourner E_NOTIMPL si le plug-in ne prend pas en charge la méthode, ou toute valeur d’échec appropriée si le plug-in ne peut pas terminer l’opération. Pour plus d’informations, consultez la section Remarques suivante.

Remarques

La méthode IPrintOemUIMXDC::AdjustImageCompression affecte les images JPEG et PNG générées par Microsoft XPS Document Converter (MXDC). La méthode IPrintOemUIMXDC::AdjustImageCompression n’affecte pas les images JPEG et PNG envoyées directement par les applications à GDI via le mécanisme de transmission directe d’images JPEG/PNG GDI (BMF_JPEG, BMF_PNG).

Les pilotes principaux, UnidrvUI.dll et PS5UI.dll, ne modifient pas les paramètres de compression d’image. Toutefois, le plug-in peut modifier la valeur initialement fournie au mxDC par le chemin d’impression GDI.

Le paramètre pCompressionMode a l’une des valeurs prédéfinies suivantes.

ENUM Type	Valeur	Signification
MXDC_IMAGETYPE_JPEGHIGH_COMPRESSION	1	Plus faible qualité et plus petite taille de fichier
MXDC_IMAGETYPE_JPEGMEDIUM_COMPRESSION	2	Taille de fichier moyenne et moyenne
MXDC_IMAGETYPE_JPEGLOW_COMPRESSION	3	Grande qualité et grande taille de fichier
MXDC_IMAGETYPE_PNG	4	Plus grande qualité et plus grande taille de fichier

Le paramètre pCompressionMode est IN OUT. Tous les autres paramètres de cette fonction sont uniquement d’entrée.

Si le plug-in ne peut pas terminer l’opération, il doit retourner un échec HRESULT approprié, ce qui entraîne l’échec du travail d’impression actuel.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible avec Windows Vista et versions ultérieures de Unidrvui.dll et de Ps5ui.dll, qui sont redistribuables. Cette méthode est également disponible pour les pilotes XPSDrv dans Microsoft Windows XP si vous avez installé le pack XPS Essentials.
plateforme cible	Bureau
d’en-tête	prcomoem.h (include Prcomoem.h)

Partager via