IPrintTicketProvider2::ConvertDevModeToPrintTicket-Methode (prdrvcom.h)

  • Artikel

Die IPrintTicketProvider2::ConvertDevModeToPrintTicket-Methode konvertiert eine DEVMODEW-Struktur in ein Druckticket.

Syntax

HRESULT ConvertDevModeToPrintTicket(
  [in] IN ULONG            cbDevmode,
  [in] IN PDEVMODE         pDevmode,
  [in] IN IXMLDOMDocument2 *pPrintTicket
);

Parameter

[in] cbDevmode

Die Größe der DEVMODEW-Eingabestruktur in Bytes. Die Größe umfasst sowohl den öffentlichen als auch den privaten Teil dieser Struktur.

[in] pDevmode

Ein Zeiger auf die DEVMODEW-Eingabestruktur , einschließlich ihrer öffentlichen und privaten Teile.

[in] pPrintTicket

Ein Zeiger auf das teilweise abgeschlossene Druckticket. Wenn IPrintTicketProvider2::ConvertDevModeToPrintTicket zurückgibt, sollten alle Einträge im Druckticket ausgefüllt werden.

Rückgabewert

IPrintTicketProvider2::ConvertDevModeToPrintTicket sollte S_OK zurückgeben, wenn der Vorgang erfolgreich ist. Andernfalls sollte diese Methode einen COM-Standardfehlercode zurückgeben.

Hinweise

Wenn das Drucksystem den Inhalt einer DEVMODEW-Struktur in ein Druckticket konvertiert, konvertiert es alle öffentlichen DEVMODEW-Felder mit Ausnahme der Felder, die vom Plug-In-Anbieter als deaktiviert angegeben wurden. Für diese deaktivierten und nicht konvertierten DEVMODEW-Felder ist der Plug-In-Anbieter für das Auffüllen der entsprechenden Druckticketwerte verantwortlich. Wenn die DEVMODEW-Momentaufnahme während eines Aufrufs von IPrintTicketProvider2::BindPrinter deaktiviert wurde, muss die Darstellung aus der Konvertierung genügend Informationen bereitstellen, um die ursprüngliche DEVMODEW-Struktur aus dem Druckticket ohne Informationsverlust zu rekonstruieren.

Die DEVMODEW-Momentaufnahme ermöglicht die Unterstützung subtiler Unterscheidungen in Optionen, die in der DEVMODEW-Struktur bereitgestellt werden, für die das Druckticket möglicherweise keine Darstellungen aufweist. Beispielsweise unterstützt DEVMODEW möglicherweise das Letter-Papierformat, während das Druckticket das LETTER-Papierformat LETTERSMALL unterstützt.

Anforderungen

Anforderung Wert
Header prdrvcom.h (einschließlich Prdrvcom.h)

Weitere Informationen

IPrintTicketProvider2

IPrintTicketProvider2::ConvertPrintTicketToDevMode