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

La IPrintOemUIMXDC::AdjustDPI méthode permet à un pilote de pipeline de filtre XPS d’utiliser UnidrvUI.dll ou PS5UI.dll pour prendre en charge la configuration de la résolution d’images.

Syntaxe

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

Paramètres

hPrinter

Handle de 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.

pDPI

Pointeur vers la résolution actuelle, en points par pouce (PPP), en supposant des pixels carrés. Si ce paramètre est configuré, sa valeur retournée doit être un entier positif.

Valeur retournée

AdjustDPI 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

Le paramètre pDPI 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 actuel.

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é XPS Essentials Pack.
Plateforme cible Desktop (Expérience utilisateur)
En-tête prcomoem.h (include Prcomoem.h)