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