Freigeben über


Konfigurationsmodule auf der Grundlage von GPD- oder PPD-Dateien

Wichtig

Die moderne Druckplattform ist die bevorzugte Methode von Windows für die Kommunikation mit Druckern. Wir empfehlen die Verwendung des Microsoft IPP-Treibers für die Posteingangsklasse zusammen mit Print Support Apps (PSA), um das Druckverhalten in Windows 10 und 11 für die Entwicklung von Druckergeräten anzupassen.

Weitere Informationen finden Sie unter Moderne Druckplattform und im Designhandbuch für die Drucksupport-App.

Für Windows Vista enthalten GPD- und PPD-Dateien die Print-Schemazuordnung und neue Einträge, die spezifisch für XPSDrv-Drucktreiber sind. Diese Änderungen gelten für die GPD- und PPD-Dateien, mit denen Sie nur GPD- oder PPD-Konfigurationsmodule und Konfigurationsmodule für Unidrv- oder Pscript5-Drucktreiber-Plug-Ins erstellen können.

XPSDrv-spezifische GPD- und PPD-Einträge

Zum Erstellen eines Drucktreiberkonfigurationsmoduls der Version 3 für einen XPSDrv-Drucktreiber mithilfe einer GPD- oder PPD-Datei müssen Sie eine der folgenden Aktionen ausführen:

  • Erstellen oder bearbeiten Sie die GPD- oder PPD-Datei. Die Datei muss die Konfigurationsstichwörter enthalten, die die vom Drucker unterstützten Features beschreiben. Standard-GPD- oder PPD-Schlüsselwörter werden automatisch öffentlichen Printschema-Schlüsselwörtern zugeordnet, aber nicht standardmäßigen Schlüsselwörtern werden standardmäßig einem privaten Namespace zugeordnet.

  • Fügen Sie die Datei Msxpsinc.gpd hinzu, wenn Sie eine GPD-Datei oder die Datei Msxpsinc.ppd erstellen, wenn Sie eine PPD-Datei erstellen. Diese Dateien enthalten die folgenden Schlüsselwörter, die angeben, dass die resultierende Konfigurationsdatei Teil eines XPSDrv-Drucktreibers ist.

    Für Msxpsinc.gpd enthält sie Folgendes:

    IsXPSDriver?: TRUE
    

    Für Msxpsinc.ppd enthält sie Folgendes:

    *MSIsXPSDriver: True
    

Das Einschließen der Datei Msxpsinc.gpd oder Msxpsinc.ppd ist der bevorzugte Ansatz, anstatt diese Attribute der GPD- oder PPD-Datei hinzuzufügen. Microsoft könnte zukünftige Attribute für XPSDrv-Treiber zur entsprechenden Include-Datei hinzufügen. Wenn Microsoft der Include-Datei die neuen Attribute hinzufügt und Sie die Include-Datei in Ihrer GPD- oder PPD-Datei verwenden, müssen Sie die GPD- oder PPD-Datei des Drucktreibers nicht bearbeiten.

Die GPD- oder PPD-Stammdateien (die in der INF-Datei als Treiber DataFile angegeben sind) für alle Microsoft Unidrv- oder PScript5-Treiber-basierten XPSDrv-Treiber müssen die entsprechende Datei Msxpsinc.gpd oder Msxpsinc.ppd enthalten.

Geben Sie z. B. für Model-foo.gpd Folgendes an:

*Include: "msxpsinc.gpd"

Bei Model-foo.ppd einfügen:

*Include: "msxpinc.ppd"

Die Druckschemazuordnung ist ein Feature der Unidrv- und PScript5-Konfigurationsmodule, die GPD- und PPD-Schlüsselwörter in ihre entsprechenden öffentlichen Druckschemastichwörter übersetzen. Standardmäßig werden alle Standard-GPD- und PPD-Schlüsselwörter auf die entsprechenden öffentlichen Druckschema-Schlüsselwörter abgebildet. Nicht standardmäßige Schlüsselwörter in einer GPD- oder PPD-Datei sind jedoch standardmäßig einem privaten, gerätespezifischen Namespace zugeordnet. Sie können diese Zuordnung verbessern, indem Sie eine oder beide der folgenden Aktionen ausführen:

  • Angeben des privaten Namespaces für nicht standardmäßige Schlüsselwörter.

  • Zuordnen von nicht standardmäßigen Feature- und Optionsstichwörtern in der GPD- oder PPD-Datei mit den entsprechenden Schlüsselwörtern aus dem öffentlichen Druckschema in der GPD- oder PPD-Datei. Diese Zuordnung ermöglicht es dem Konfigurationsmodul, die PrintTicket- und PrintCapabilities-Daten als öffentliche Printschema-Features zu generieren.

GPD-Dateibeispiel

Das folgende Codebeispiel zeigt eine GPD-Datei, die die Einträge und Schlüsselwörter veranschaulicht, um ein Konfigurationsmodul der Version 3 für einen XPSDrv-Drucktreiber zu erstellen.

*%
*% Copyright (c) 2004 - 2006 Microsoft Corporation
*% All Rights Reserved.
*%
*GPDFileVersion: "1.0"
*GPDSpecVersion: "1.0"
*GPDFileName:    "plugfest.gpd"
*Include:        "StdNames.gpd"
*%
*% Include XPSDrv include file
*%
*Include:        "MSXpsInc.gpd"
*ModelName:      "Microsoft XPS Passthrough Driver Sample"
*MasterUnits:    PAIR(1200, 1200)
*ResourceDLL:    "unires.dll"
*PrinterType:    PAGE
*MaxCopies:      1

*%
*% IHV Private Namespace
*%
*PrintSchemaPrivateNamespaceURI:"https://www.ihv.com/schema/2006"
*%
*% IHV Private Feature
*%
*Feature: IHVStapling { 
*PrintSchemaKeywordMap: "JobStapleAllDocuments"
*Option: Enabled {
  *PrintSchemaKeywordMap: "StapleTopLeft" }
*Option: Disabled {
  *PrintSchemaKeywordMap: "None"  }
}