Méthode IPrintOemUIMXDC ::AdjustImageableArea (prcomoem.h)
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) |