IPrintTicketProvider::ConvertPrintTicketToDevMode-Methode (prdrvcom.h)

Die IPrintTicketProvider::ConvertPrintTicketToDevMode-Methode konvertiert ein Druckticket in eine DEVMODEW--Struktur.

Syntax

HRESULT ConvertPrintTicketToDevMode(
  [in]  IN IXMLDOMDocument2 *pPrintTicket,
  [in]  IN ULONG            cbDevmodeIn,
  [in]  IN PDEVMODE         pDevmodeIn,
  [out] OUT ULONG           *pcbDevmodeOut,
  [out] OUT PDEVMODE        *ppDevmodeOut
);

Parameter

[in] pPrintTicket

Ein Zeiger auf das Eingabedruckticket. IPrintTicketProvider::ConvertPrintTicketToDevMode konvertiert die Einstellungen im Eingabedruckticket in Felder in der DEVMODEW--Struktur.

[in] cbDevmodeIn

Die Größe der Eingabe DEVMODEW--Struktur in Byte. Diese Größe umfasst sowohl die öffentlichen als auch die privaten Abschnitte der DEVMODEW--Struktur.

[in] pDevmodeIn

Ein Zeiger auf die Eingabe DEVMODEW Struktur, die Standardeinstellungen enthält. Die DEVMODEW--Struktur kann die Standardstruktur der Druckwarteschlange DEVMODEW- sein, oder es kann sich um den Benutzerstandard DEVMODEW--Struktur sein. Da dieser Parameter die Standardstruktur des Benutzers DEVMODEW- darstellen kann, muss der OEM-Plug-In-Anbieter die Daten in dieser Struktur überprüfen. Ein Benutzerstandard DEVMODEW- Struktur ist möglicherweise für einen bestimmten Treiber nicht gültig, z. B. wenn sich der Treiber der Druckwarteschlange ändert oder aktualisiert wird.

[out] pcbDevmodeOut

Ein Zeiger auf eine Variable, die die Größe der Ausgabe DEVMODEW--Struktur in Byte enthält.

[out] ppDevmodeOut

Ein Zeiger auf eine Variable, die die Adresse der Ausgabe DEVMODEW--Struktur enthält. Wenn IPrintTicketProvider::ConvertPrintTicketToDevMode erfolgreich zurückgegeben wird, werden die Elemente der Ausgabe DEVMODEW--Struktur zurückgesetzt, um die Einstellungen im Druckticket widerzuspiegeln. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Rückgabewert

IPrintTicketProvider::ConvertPrintTicketToDevMode sollte S_OK zurückgeben, wenn der Vorgang erfolgreich ist. Andernfalls sollte diese Methode einen standardmäßigen COM-Fehlercode zurückgeben.

Bemerkungen

Der Kerntreiber ruft die IPrintTicketProvider::ConvertPrintTicketToDevMode Methode auf, bevor sie den Teil der Konvertierung eines Drucktickets in eine DEVMODEW- Struktur ausführt. Im Aufruf dieser Methode übergibt der Kerntreiber ein Eingabedruckticket, das vollständig ausgefüllt ist, und eine DEVMODEW- Struktur, die auf Standardwerte festgelegt ist. Bei der Konvertierung muss das Plug-In alle Änderungen rückgängig machen, die es während der vorherigen Konvertierung von einer DEVMODEW- Struktur in ein Druckticket an dem Druckticket vorgenommen hat. Wenn das Plug-In während dieser vorherigen Konvertierung ein Feature von einem privaten Namespace in den öffentlichen Namespace verschoben hat, muss das Plug-In das Feature in einem Format wiederherstellen, das für den Kerntreiber geeignet ist, d. h. in das Format, in dem der Kerntreiber das Feature zuvor im Druckticket platziert hatte, das dem Plug-In im IPrintOemPrintTicketProvider bereitgestellt wurde: ConvertDevModeToPrintTicket Methode. Diese Wiederherstellung ist erforderlich, damit der Kerntreiber ein Feature im Druckticket erkennen und seine Einstellungen im privaten Teil der DEVMODEW- Struktur des Kerntreibers widerspiegeln kann, während der Kerntreiber seinen Teil des Printticket-zu-DEVMODEW Konvertierung ausführt.

Bevor das System ein Druckticket wieder in eine DEVMODEW- Struktur konvertiert, lädt es zuerst die Standard-DEVMODEW-. Das System ruft dann die IPrintTicketProvider::BindPrinter-Methode des Anbieters auf. Diese Methode sollte dann alle Vom Druckticket unterstützten Einstellungen lesen und diese Einstellungen in die DEVMODEW- Struktur einfügen. Beachten Sie, dass nicht alle Features notwendigerweise dargestellt werden, und dass häufig optionsinstanzen, die vorhanden sind, möglicherweise nicht alle Instanzen der Scored-Eigenschaft enthalten, die der Anbieter normalerweise auffüllt. Wenn der Anbieter Änderungen an den Einstellungen vorgibt, die vom System während der Konvertierung vom Druckticket in DEVMODEW-aufgefüllt wurden, sollte der Anbieter diese Änderung in dieser Methode umkehren. Nachdem der Anbieter zurückgegeben wurde, überschreibt das System dann alle öffentlichen DEVMODEW- Einstellungen, die im Druckticket dargestellt werden, jedoch nicht explizit vom Anbieter deaktiviert werden.

Anforderungen

Anforderung	Wert
Header-	prdrvcom.h (einschließlich Prdrvcom.h)

Siehe auch

IPrintTicketProvider-

IPrintTicketProvider::ConvertDevModeToPrintTicket