IPrintOemUIMXDC ::AdjustImageableArea, méthode (prcomoem.h)
La méthode IPrintOemUIMXDC::AdjustImageableArea 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 la direction de la rotation.
Syntaxe
HRESULT AdjustImageableArea(
HANDLE hPrinter,
DWORD cbDevMode,
const PDEVMODE pDevMode,
DWORD cbOEMDM,
const PVOID pOEMDM,
PRECTL prclImageableArea
);
Paramètres
hPrinter
Handle vers 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 de RECTL qui contient la zone imprimable. Ce paramètre est rempli par UnidrvUI.dll ou PS5UI.dll avec des 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 retourner.
Valeur de retour
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 Remarques suivante.
Remarques
Le paramètre prclImageableArea est IN OUT. Tous les autres paramètres de cette méthode sont uniquement d’entrée.
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.
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) |