Méthode IPrintTicketProvider2 ::ConvertDevModeToPrintTicket (prdrvcom.h)
La méthode IPrintTicketProvider2 ::ConvertDevModeToPrintTicket convertit une structure DEVMODEW en ticket d’impression.
Syntaxe
HRESULT ConvertDevModeToPrintTicket(
[in] IN ULONG cbDevmode,
[in] IN PDEVMODE pDevmode,
[in] IN IXMLDOMDocument2 *pPrintTicket
);
Paramètres
[in] cbDevmode
Taille, en octets, de la structure DEVMODEW d’entrée. La taille inclut les parties publiques et privées de cette structure.
[in] pDevmode
Pointeur vers la structure DEVMODEW d’entrée, y compris ses parties publique et privée.
[in] pPrintTicket
Pointeur vers le ticket d’impression partiellement terminé. Lorsque IPrintTicketProvider2 ::ConvertDevModeToPrintTicket est retourné, toutes les entrées du ticket d’impression doivent être renseignées.
Valeur retournée
IPrintTicketProvider2 ::ConvertDevModeToPrintTicket doit retourner S_OK si l’opération réussit. Sinon, cette méthode doit retourner un code d’erreur COM standard.
Remarques
Lorsque le système d’impression convertit le contenu d’une structure DEVMODEW en ticket d’impression, il convertit tous les champs DEVMODEW publics, sauf ceux que le fournisseur de plug-in a indiqué doivent être désactivés. Pour ces champs DEVMODEW désactivés et non convertis, le fournisseur de plug-ins est chargé de remplir les valeurs de ticket d’impression correspondantes. Si le instantané DEVMODEW a été désactivé lors d’un appel à IPrintTicketProvider2 ::BindPrinter, la représentation de la conversion doit fournir suffisamment d’informations pour reconstruire la structure DEVMODEW d’origine à partir du ticket d’impression sans perte d’informations.
L’instantané DEVMODEW permet de prendre en charge des distinctions subtiles dans les options fournies dans la structure DEVMODEW pour lesquelles le ticket d’impression n’a peut-être pas de représentations. Par exemple, DEVMODEW peut prendre en charge le format de papier LETTER, tandis que le ticket d’impression prend en charge le format de papier LETTERSMALL.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | prdrvcom.h (inclure Prdrvcom.h) |