IPrintTicketProvider2 ::ConvertDevModeToPrintTicket, méthode (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 d’entrée DEVMODEW. La taille inclut les parties publiques et privées de cette structure.
[in] pDevmode
Pointeur vers l’entrée structure DEVMODEW, y compris ses parties publiques et privées.
[in] pPrintTicket
Pointeur vers le ticket d’impression partiellement terminé. Lorsque IPrintTicketProvider2 ::ConvertDevModeToPrintTicket retourne, toutes les entrées du ticket d’impression doivent être renseignées.
Valeur de retour
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 publics DEVMODEW, sauf ceux que le fournisseur de plug-in a indiqués doit être désactivé. Pour ces DEVMODEW champs désactivés et non convertis, le fournisseur de plug-ins est chargé de remplir les valeurs de ticket d’impression correspondantes. Si l’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 d’origine DEVMODEW à partir du ticket d’impression sans perte d’informations.
L’instantané DEVMODEW permet la prise en charge des distinctions subtiles dans les options fournies dans la structure DEVMODEW pour laquelle le ticket d’impression n’a peut-être pas de représentations. Par exemple, DEVMODEW peut prendre en charge la taille du papier LETTER tandis que le ticket d’impression prend en charge la taille du papier LETTERMALL.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | prdrvcom.h (include Prdrvcom.h) |