Méthode IPrintTicketProvider ::ConvertDevModeToPrintTicket (prdrvcom.h)
La méthode IPrintTicketProvider ::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 publique et privée de cette structure.
[in] pDevmode
Pointeur vers la structure DEVMODEW d’entrée, y compris ses parties publiques et privées.
[in] pPrintTicket
Pointeur vers le ticket d’impression partiellement terminé. Lorsque IPrintTicketProvider ::ConvertDevModeToPrintTicket retourne, toutes les entrées du ticket d’impression doivent être renseignées.
Valeur retournée
IPrintTicketProvider ::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, à l’exception de ceux que le fournisseur de plug-in a indiqué doivent être désactivés. Pour ces champs DEVMODEW qui sont 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 à IPrintTicketProvider ::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.
Le instantané DEVMODEW permet de prendre en charge les distinctions subtiles dans les options fournies dans la structure DEVMODEW pour lesquelles le ticket d’impression peut ne pas avoir 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) |