Partager via


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)

Voir aussi

IPrintTicketProvider2

IPrintTicketProvider2 ::ConvertPrintTicketToDevMode