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

Article
02/07/2025

La méthode IPrintOemUIMXDC::AdjustDPI 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 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.

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 de retour

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 Remarques suivante.

Remarques

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