IPrintTicketProvider::ConvertDevModeToPrintTicket-Methode (prdrvcom.h)

  • Artikel

Die IPrintTicketProvider::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 Byte. 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 IPrintTicketProvider::ConvertDevModeToPrintTicket zurückgibt, sollten alle Einträge im Druckticket ausgefüllt werden.

Rückgabewert

IPrintTicketProvider::ConvertDevModeToPrintTicket sollte S_OK zurückgeben, wenn der Vorgang erfolgreich ist. Andernfalls sollte diese Methode einen standardmäßigen COM-Fehlercode zurückgeben.

Hinweise

Wenn das Drucksystem den Inhalt einer DEVMODEW-Struktur in ein Druckticket konvertiert, werden alle öffentlichen DEVMODEW-Felder mit Ausnahme der felder konvertiert, die der Plug-In-Anbieter deaktiviert hat. Für diese DEVMODEW-Felder , die deaktiviert und nicht konvertiert werden, ist der Plug-In-Anbieter für das Auffüllen der entsprechenden Druckticketwerte verantwortlich. Wenn der DEVMODEW-Momentaufnahme während eines Aufrufs von IPrintTicketProvider::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 für subtile 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 LETTERSMALL-Papierformat unterstützt.

Anforderungen

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

Weitere Informationen

IPrintTicketProvider

IPrintTicketProvider::ConvertPrintTicketToDevMode