Erstellen eines einfachen v4-Druckertreibers

Wichtig

Es wird empfohlen, den IPP-Klassentreiber von Microsoft zusammen mit Print Support Apps (PSA) zu verwenden, um die Druckoberfläche in Windows 10 und 11 für die Entwicklung von Druckergeräten anzupassen.

Weitere Informationen finden Sie im Leitfaden zum Erstellen von Druckunterstützungs-Apps.

Wichtig

Microsoft hat die End-of-Life-Wartung für Legacy-Druckertreiber v3 und v4 angekündigt.

Weitere Informationen finden Sie unter Wartungsendeplan für Druckertreiber von Drittanbietern unter Windows.

Warnung

Dieses Tutorial zu Druckertreibern enthält mehrere Fehler und kann derzeit nicht verwendet werden.

Erstellen Sie einen einfachen v4-Druckertreiber mithilfe des Treiberentwicklungs-Assistenten in Microsoft Visual Studio 2019, um die Mindestanzahl von Features zum Erstellen eines funktionsfähigen Druckertreibers auszuwählen.

Die Anweisungen in diesem Thema konzentrieren sich auf die Schritte, die zum Erstellen eines Treibers erforderlich sind, und erläutern nicht die vielen Druckertreiberoptionen, die im Assistenten verfügbar sind.

In diesem Thema soll eine Einführung in den Prozess beim Entwickeln eines Druckertreibers in Visual Studio 2019 bereitgestellt werden.

Einen ausführlicheren Einblick in die Druckertreiberoptionen finden Sie unter Erkunden der Treiberoptionen im Assistenten.

Voraussetzungen

Befolgen Sie die Anleitung unter Herunterladen des Windows Driver Kit (WDK), und stellen Sie sicher, dass Sie die folgenden Elemente abgeschlossen haben:

1. Installieren Sie Visual Studio 2019 mit der Workload Desktopentwicklung mit C++ und der richtigen Version des Windows 10 SDK.

2. Installieren Sie das Windows Driver Kit (WDK) für Windows 10, Version 2004.

3. Installieren Sie die WdK-Erweiterung (Windows Driver Kit) für Visual Studio 2019.

Auswählen von Features für den Basistreiber

1. Wählen Sie in Visual Studio im Menü Standard Datei>Neues>Projekt aus.

2. Geben Sie im Fenster Neues Projekt im Suchfeld oben rechts druckertreiber v4 ein, und drücken Sie die EINGABETASTE. Dadurch werden alle Treibervorlagen abgerufen, deren Namen den Suchtext enthalten.

3. Wählen Sie im mittleren Bereich Druckertreiber V4 aus.

4. Geben Sie im Feld Name einen Namen für Ihren Treiber ein, und wählen Sie dann OK aus. Sie können beispielsweise MyV4PrintDriver eingeben.

5. Wählen Sie im Assistenten zum Erstellen eines v4-Drucktreibers unter Treiberrenderingtyp auswählen die Option V4-Drucktreiber mit benutzerdefinierten Renderingfiltern (nur XPS akzeptiert) aus.

6. Behalten Sie für alle anderen Optionen die Standardeinstellungen bei, und wählen Sie Weiter aus.

7. Behalten Sie im Abschnitt Setupinformationen des Assistenten die Standardeinstellungen bei, und wählen Sie dann Weiter aus.

8. Belassen Sie im Abschnitt Setupinformationen (Seite 2) des Assistenten alle Optionen bei den Standardeinstellungen, und wählen Sie dann Weiter aus.

Microsoft Visual Studio verwendet die oben genannten Auswahlen, um die Projektdateien für MyV4PrintDriver zu generieren.

Überprüfen der generierten Treiberdateien

1. Navigieren Sie zum Ordner für die generierten Treiberdateien. Wenn Sie Ihr Projekt beispielsweise MyV4PrintDriver genannt haben, werden die Dateien standardmäßig am folgenden Speicherort gespeichert: Eigene Dokumente > Visual Studio 2019-Projekte >> MyV4PrintDriver MyV4PrintDriver>.

2. Stellen Sie sicher, dass der Ordner die folgenden Dateien enthält:

   Dateiname	Dateityp
   MyV4PrintDriver.gpd	Druckerbeschreibungsdatei
   MyV4PrintDriver.inf	Setupinformationsdatei
   MyV4PrintDriver.vcxproj	C++-Projektdatei
   MyV4PrintDriver.vcxproj.filters	C++-Projektfilterdatei
   MyV4PrintDriver-manifest.ini	Konfigurationseinstellungsdatei (das Drucktreibermanifest)
   V4PrintDriver-Intellisense.js	JavaScript-Datei für IntelliSense
   V4PrintDriver-Intellisense-Windows8.1.js	JavaScript-Datei für IntelliSense

Beachten Sie aus der obigen Tabelle, dass eine der erstellten Dateien eine INF-Datei ist. Beachten Sie, dass Visual Studio eine skelettartige INF-Datei erstellt hat, die abgeschlossen werden muss, damit sie zum Installieren des Treibers verwendet werden kann.

Erstellen einer eindeutigen PrinterDriverID für den Treiber

1. Wählen Sie im Menü Visual Studio-Tools GUID erstellen aus.

2. Wählen Sie Option 4 aus. Registrierungsformat , und wählen Sie die Schaltfläche Kopieren aus.

3. Erweitern Sie in Visual Studio im Projektmappen-Explorer den Knoten MyV4PrintDriver.

4. Wählen Sie Treiberdateien aus, und sehen Sie sich dann im Fenster Eigenschaften den Wert für das Feld Eindeutiger Bezeichner an. Ersetzen Sie diesen Wert durch die GUID, die Sie mit Einfügen generiert haben.

Vervollständigen der INF-Datei

Im Projekt MyV4PrintDriver sollte ein Eintrag für Treiberdateien vorhanden sein. Öffnen Sie diese Datei, und die Datei MyV4PrintDriver.inf sollte aufgelistet werden. Öffnen Sie diese Datei.

1. Aktualisieren des Copyright-Hinweises

Die ersten 2 Zeilen der INF-Datei sind der Copyright-Hinweis für das Treiberpaket.

Zeile 1 enthält das Jahr und den Namen Ihres Unternehmens. Ersetzen Sie die Zeichen JJJJ durch das aktuelle Jahr, und ersetzen Sie die Zeichen <Ihr Herstellername> durch den Namen Ihres Unternehmens.

In Zeile 2 wird der Inhalt des Treiber-INF beschrieben, einschließlich Informationen zum Herstellernamen und Gerätemodell. Ersetzen Sie die Zeichen <Ihr Herstellername> durch den Namen Ihres Unternehmens, und ersetzen Sie die Zeichen des Druckermodells>< durch den Modellnamen des Druckers, der vom Treiber unterstützt wird.

Wenn das Jahr z. B. 2021 ist und der Name Ihres Unternehmens Fabrikam lautet und das Druckgerätemodell 1234 lautet, geben Sie Folgendes ein:

; Copyright (c) 2021 Fabrikam
; INF file for the Fabrikam 1234 print driver

2. Überprüfen Sie, ob der Abschnitt [Version] korrekt ist.

Suchen Sie die Zeile, die [Version] enthält.

• Überprüfen Sie, und stellen Sie sicher, dass diese Zeile angezeigt wird:

  ClassVer=4.0
  

• Überprüfen Sie, und stellen Sie sicher, dass diese Zeile angezeigt wird:

  Signature="$WINDOWS NT$"
  

3. Konfigurieren des Abschnitts [SourceDisksFiles]

Suchen Sie die Zeile, die [SourceDisksFiles] enthält.

Geben Sie darunter die folgenden Zeilen ein:

MyV4PrintDriver.gpd=1
MyV4PrintDriver-manifest.ini=1
MyV4PrintDriverRenderFilter-PipelineConfig.xml=1
MyV4PrintDriverRenderFilter.dll=1

4. Konfigurieren des Abschnitts [DriverFiles]

Suchen Sie die Zeile, die [DriverFiles] enthält.

Geben Sie darunter die folgenden Zeilen ein:

MyV4PrintDriver.gpd
MyV4PrintDriver-manifest.ini
MyV4PrintDriverRenderFilter-PipelineConfig.xml
MyV4PrintDriverRenderFilter.dll

5. Konfigurieren des Abschnitts [Standard.NT$ARCH$]

Suchen Sie die Zeile, die [Standard.NT$ARCH$] enthält.

In diesem Abschnitt wird für jedes Modell auf den Install Abschnitt des INF verwiesen. Wenn das Modell Ihres Druckers beispielsweise Fabrikam 1234 ist, geben Sie Folgendes ein:

"Fabrikam 1234"=DriverInstall, USBPRINT\\Fabrikam1234
"Fabrikam 1234"=DriverInstall, WSDPRINT\\Fabrikam1234

6. Hinzufügen der PrinterDriverID zur INF-Datei

Erweitern Sie in Visual Studio im Projektmappen-Explorer den Knoten MyV4PrintDriver.

Wählen Sie Treiberdateien aus, und sehen Sie sich dann im Fenster Eigenschaften den Wert für das Feld Eindeutiger Bezeichner an. Dies ist die Treiber-ID (die GUID). Markieren Sie es, und kopieren Sie sie.

Geben Sie in der INF-Datei im Abschnitt [Standard.NT$ARCH$] die folgende Zeile ein:

"Fabrikam 1234"=DriverInstall,

Fügen Sie dann nach dem Komma die GUID ein, die Sie im vorherigen Schritt kopiert haben. Der abgeschlossene Abschnitt [Standard.NT$ARCH$] sollte wie folgt aussehen:

"Fabrikam 1234"=DriverInstall, {GUID}
"Fabrikam 1234"=DriverInstall, USBPRINT\Fabrikam1234
"Fabrikam 1234"=DriverInstall, WSDPRINT\Fabrikam1234

7. Konfigurieren des Abschnitts [Strings]

Suchen Sie die Zeile, die [Zeichenfolgen] enthält.

Darunter finden Sie die Definition der ManufacturerName-Zeichenfolge . Ersetzen Sie die Zeichen <Ihr Herstellername> durch den Namen Ihres Unternehmens, um einen Herstellernamen für den Zieldrucker anzugeben, und löschen Sie den Rest der Zeile, die den enthält. TODO:

Wenn ihr Unternehmen beispielsweise Fabrikam heißt, geben Sie Folgendes ein:

ManufacturerName="Fabrikam"

8. Speichern der INF-Datei

Wenn Sie die INF-Datei abschließen, sollte sie wie folgt aussehen:

; Copyright (c) 2021 Fabrikam
; INF file for the Fabrikam 1234 print driver

[Version]
Signature="$Windows NT$"
Class=Printer
ClassGuid={4D36E979-E325-11CE-BFC1-08002BE10318}
Provider=%ManufacturerName%
CatalogFile=MyV4PrintDriver.cat
ClassVer=4.0
DriverVer=03/17/2014,1.0.0.0
PnpLockdown=1

[Manufacturer]
%ManufacturerName%=Standard,NT$ARCH$

[Standard.NT$ARCH$]
"Fabrikam 1234"=DriverInstall, {GUID}
"Fabrikam 1234"=DriverInstall, USBPRINT\Fabrikam1234
"Fabrikam 1234"=DriverInstall, WSDPRINT\Fabrikam1234

[DriverInstall]
CopyFiles=DriverFiles

[DriverFiles]
MyV4PrintDriver.gpd
MyV4PrintDriver-manifest.ini
MyV4PrintDriverRenderFilter-PipelineConfig.xml
MyV4PrintDriverRenderFilter.dll

[DestinationDirs]
DefaultDestDir = 66000

[SourceDisksNames]
1 = %DiskName%,,,""

[SourceDisksFiles]
MyV4PrintDriver.gpd=1
MyV4PrintDriver-manifest.ini=1
MyV4PrintDriverRenderFilter-PipelineConfig.xml=1
MyV4PrintDriverRenderFilter.dll=1

[Strings]
ManufacturerName="Fabrikam"
DiskName="MyV4PrintDriver Installation Disk"

Aktualisieren der Liste der Treiberdateien

1. Erweitern Sie in Visual Studio im Projektmappen-Explorer den Knoten MyV4PrinterDriver.

2. Wählen Sie die Datei MyV4PrintDriver.gpd aus, und ziehen Sie sie auf den Knoten Treiberdateien .

3. Gehen Sie auch mit MyV4PrintDriver-manifest.ini vor.

Hinzufügen der Pipelinekonfigurationsdatei zum Treiberpaket

1. Halten Sie im Projektmappen-Explorer das Projekt MyV4PrintDriver gedrückt (oder klicken Sie mit der rechten Maustaste darauf), und wählen Sie dann Eigenschaften aus.

2. Erweitern Sie im Fenster MyV4PrintDriver-Eigenschaftenseiten die Option Konfigurationseigenschaften im linken Bereich.

3. Erweitern Sie Treiberinstallation, und wählen Sie dann Paketdateien aus.

4. Wählen Sie im rechten Bereich die Option aus, und klicken Sie dann in den <aufgelisteten Dateien auf die Zeile Bearbeiten...> .

   

5. Ersetzen Sie den Platzhalter durch den relativen Pfad der Pipelinekonfigurationsdatei, z. B. , ../MyV4PrintDriver Render Filter/MyV4PrintDriverRenderFilter-PipelineConfig.xmlund klicken Sie dann auf OK.

   

Hinzufügen eines Verweises auf den Renderfilter zum Treiberpaket

1. Erweitern Sie in Visual Studio im Projektmappen-Explorer den Knoten MyV4PrinterDriver.

2. Halten Sie den Knoten>Verweise gedrückt (oder klicken Sie mit der rechten Maustaste darauf), und wählen Sie Verweis hinzufügen aus.

3. Aktivieren Sie das Kontrollkästchen für MyV4PrintDriver Renderfilter, und klicken Sie dann auf OK.

Konfigurieren der Treiberlösung für Debuggen und Bereitstellung

1. Halten Sie im Projektmappen-Explorer das Projekt MyV4PrintDriver gedrückt (oder klicken Sie mit der rechten Maustaste darauf), und wählen Sie dann Eigenschaften aus.

2. Erweitern Sie im Fenster MyV4PrintDriver-Eigenschaftenseiten die Option Konfigurationseigenschaften im linken Bereich.

3. Erweitern Sie Treiberinstallation, und wählen Sie dann Bereitstellung aus. Führen Sie im rechten Bereich die folgenden Schritte aus:

   • Stellen Sie sicher, dass der Name des Zielcomputers konfiguriert ist. Wenn nicht, wählen Sie "..." und befolgen Sie die Anweisungen im Assistenten zum Konfigurieren von Geräten , um einen Remotezielcomputer einzurichten.

   • Aktivieren Sie Vorherige Treiberversionen vor der Bereitstellung entfernen.

   • Wählen Sie Installieren/Neu installieren und überprüfen aus, und wählen Sie dann im Dropdownfeld Standardinstallationstask für Druckertreiberpaket aus.

   • Geben Sie den Namen des Treibers in das Feld Optionale Argumente ein (ohne Anführungszeichen um den Namen).

   • Klicken Sie auf OK.

Konfigurieren der Treibersignatur

1. Halten Sie im Projektmappen-Explorer das Projekt MyV4PrintDriver gedrückt (oder klicken Sie mit der rechten Maustaste darauf), und wählen Sie dann Eigenschaften aus.

2. Erweitern Sie im Fenster MyV4PrintDriver-Eigenschaftenseiten die Option Konfigurationseigenschaften im linken Bereich.

3. Erweitern Sie Treibersignatur, und wählen Sie dann Allgemein aus.

4. Vergewissern Sie sich im rechten Bereich, dass der Unterzeichenmodus auf Test sign (Test sign) festgelegt ist.

5. Wählen Sie Testzertifikat und dann im Dropdownfeld Testzertifikat erstellen aus.

6. Wählen Sie TimeStampServer und dann Verisign aus dem Dropdownfeld aus.

7. Klicken Sie auf OK.

Erstellen und Bereitstellen des Treibers

1. Wählen Sie in Projektmappen-Explorerprojektmappe MyV4PrintDriver (2 Projekte) aus, halten Sie sie gedrückt (oder klicken Sie mit der rechten Maustaste darauf), und wählen Sie Projektmappe erstellen aus.

2. Nach Abschluss des Buildprozesses wird der Treiber automatisch installiert. Stellen Sie sicher, dass im Ausgabefenster keine Fehler vorhanden sind.

Testen des Treibers

Erstellen Sie eine Druckwarteschlange entweder mithilfe von Plug-and-Play oder mit dem Assistenten zum Hinzufügen von Druckern.

Weitere Informationen zu INF-Dateien für den v4-Druckertreiber finden Sie unter V4 Driver INF.

Beachten Sie zusätzlich zu den Dateien in der vorherigen Tabelle, dass ein MyV4PrintDriver-Renderfilterordner erstellt wurde. Dies ist die Renderfilterprojektvorlage und bietet eine gute Grundlage für die Erstellung eines XPS-Renderingfilters und einer XPS-Filterpipelinekonfigurationsdatei. Weitere Informationen zu XPS-Renderingfiltern finden Sie unter XPSDrv-Rendermodul, und ein Beispiel für einen XPS-Renderingfilter finden Sie im XPS-Rasterisierungsfilter-Beispiel .