IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket-Methode (prcomoem.h)
Die IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket-Methode konvertiert eine DEVMODEW-Struktur in ein Druckticket.
Syntax
HRESULT ConvertDevModeToPrintTicket(
[in] ULONG cbDevmode,
[in] PDEVMODE pDevmode,
[in] ULONG cbDrvPrivateSize,
[in] PVOID pPrivateDevmode,
[in, out] 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-Struktur der Eingabe.
[in] cbDrvPrivateSize
Die Größe der privaten DEVMODEW-Struktur des Plug-Ins in Bytes.
[in] pPrivateDevmode
Ein Zeiger auf die private DEVMODEW-Struktur des Plug-Ins.
[in, out] pPrintTicket
Ein Zeiger auf das teilweise abgeschlossene Druckticket. Wenn IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket zurückgibt, sollten alle Einträge im Druckticket ausgefüllt werden.
Rückgabewert
IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket sollte S_OK zurückgeben, wenn der Vorgang erfolgreich ist. Andernfalls sollte diese Methode einen standardmäßigen COM-Fehlercode zurückgeben.
Hinweise
Der Kerntreiber ruft die IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket-Methode mit einem Eingabedruckticket auf, das mit öffentlichen features und Unidrv-private oder Pscript5-private aufgefüllt ist. Das Plug-In kann DEVMODEW-Einstellungen im öffentlichen Teil oder im privaten Teil des Plug-Ins basierend auf den Einstellungen im Eingabedruckticket festlegen. Zusätzlich zum Festlegen neuer DEVMODEW-Elemente kann das Plug-In vorhandene Einstellungen im öffentlichen Teil der DEVMODEW-Struktur ändern.
Die DEVMODEW-Strukturfelder, die mit dem für den Client relevanten Teil der DEVMODEW-Struktur korrelieren, wurden bereits aufgefüllt, bevor IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket aufgerufen wird, einschließlich des öffentlichen Teils der DEVMODEW-Struktur und ohne die privat definierten Werte im öffentlichen Teil der DEVMODEW-Struktur.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | prcomoem.h (include Prcomoem.h) |