IPrintTicketProvider2::ConvertDevModeToPrintTicket-Methode (prdrvcom.h)
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) |