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

Weitere Informationen

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::ConvertPrintTicketToDevMode