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

Article
02/26/2024

La IPrintOemUIMXDC::AdjustImageCompression méthode 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 de l’imprimante en cours d’interrogation.

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 retournée

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 Notes qui suit.

Remarques

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

Les principaux pilotes, 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	Qualité la plus faible et taille de fichier la plus petite
MXDC_IMAGETYPE_JPEGMEDIUM_COMPRESSION	2	Qualité moyenne et taille de fichier moyenne
MXDC_IMAGETYPE_JPEGLOW_COMPRESSION	3	Haute qualité et grande taille de fichier
MXDC_IMAGETYPE_PNG	4	Qualité supérieure et taille de fichier la plus élevée

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

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible avec Windows Vista et les versions ultérieures de Unidrvui.dll et 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	Desktop (Expérience utilisateur)
En-tête	prcomoem.h (inclure Prcomoem.h)

Share via