Share via

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

  • Article

La IPrintOemUIMXDC::AdjustImageableArea 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 zone imprimable, y compris l’orientation et le sens de rotation.

Syntaxe

HRESULT AdjustImageableArea(
  HANDLE         hPrinter,
  DWORD          cbDevMode,
  const PDEVMODE pDevMode,
  DWORD          cbOEMDM,
  const PVOID    pOEMDM,
  PRECTL         prclImageableArea
);

Paramètres

hPrinter

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

cbDevMode

Taille de la structure DEVMODE , en octets, 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.

prclImageableArea

Pointeur vers une structure RECTL qui contient la zone imprimable. Ce paramètre est rempli par UnidrvUI.dll ou PS5UI.dll avec les données du GPD ou PPD correspondant, avant que le paramètre ne soit passé au plug-in. Le plug-in peut ensuite mettre à jour ces données avant de revenir.

Valeur retournée

AdjustImageableArea retourne S_OK si cette 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 prclImageableArea est IN OUT. Tous les autres paramètres de cette méthode sont en entrée uniquement.

Si le plug-in ne peut pas terminer l’opération, il doit retourner une valeur HRESULT d’échec appropriée, 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)

Voir aussi

IPrintOemUIMXDC

RECTL