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 Eingabe DEVMODEW--Struktur in Byte. Die Größe umfasst sowohl die öffentlichen als auch privaten Teile dieser Struktur.
[in] pDevmode
Ein Zeiger auf die Eingabe DEVMODEW--Struktur, einschließlich der öffentlichen und privaten Teile.
[in] pPrintTicket
Ein Zeiger auf das teilweise fertige 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 standardmäßigen COM-Fehlercode zurückgeben.
Bemerkungen
Wenn das Drucksystem den Inhalt einer DEVMODEW--Struktur in ein Druckticket konvertiert, konvertiert es alle öffentlichen DEVMODEW--Felder außer denen, die der Plug-In-Anbieter angegeben hat, deaktiviert werden sollte. Für diese DEVMODEW Felder, die deaktiviert und nicht konvertiert werden, ist der Plug-In-Anbieter dafür verantwortlich, die entsprechenden Druckticketwerte aufzufüllen. 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 zu rekonstruieren, ohne dass Informationen verloren gehen.
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 kann DEVMODEW- das LETTER-Papierformat unterstützen, während das Druckticket das LETTERMALL-Papierformat unterstützt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | prdrvcom.h (einschließlich Prdrvcom.h) |