V4-Treiber-INF

Wichtig

Es wird empfohlen, den IPP-Posteingangsklassentreiber von Microsoft zusammen mit Druckunterstützungs-Apps (PSA) zu verwenden, um die Druckoberfläche in Windows 10 und 11 für die Druckergeräteentwicklung anzupassen.

Weitere Informationen finden Sie im Designhandbuch für Druckunterstützungs-Apps.

Das v4-Drucktreiber-Setupmodell verwendet weiterhin INF-Dateien, verwendet aber auch eine neue Manifestdatei, um die druckerspezifischen Setupanweisungen zu erfassen.

Wichtig

Ab dem WDK für Windows 11 Version 22H2 werden verteilbare WDF-Co-Installer nicht mehr unterstützt. Informationen zum Umgang mit dieser Änderung finden Sie unter WDF Redistributable Co-Installer funktionieren nicht im Artikel bekannte WDK-Probleme .

Beispiel-INF

Beachten Sie, dass die INF-Beispieldatei des v4-Drucktreibers in diesem Thema keine druckerspezifischen Anweisungen enthält. Die druckerspezifischen Anweisungen sind in der v4-Manifestdatei enthalten, die immer mit "–manifest.ini" endet. Jeder Treiber in einem Treiberpaket kann eine eigene v4-Manifestdatei angeben.

Die folgende Beispiel-INF-Datei geht davon aus, dass ein fiktives Unternehmen, Fabrikam, Druckgeräte hergestellt hat, die für die Ausführung mit dem v4-Drucktreiber installiert werden.

[Version]
Signature="$Windows NT$"
Provider="Fabrikam"
Class=Printer
ClassGUID={4D36E979-E325-11CE-BFC1-08002BE10318}
CatalogFile=prnfa999.CAT
DriverVer=09/12/2010,6.2.8060.4
ClassVer=4.0 ;This causes v4 setup to take place
PnpLockdown=1

[Manufacturer]
"Fabrikam"=Fabrikam,NTamd64

[Fabrikam.NTamd64] ;Add your models here
"Fabrikam Laser 9000" =        Laser9000,Fabrik9000_sdfjkals                     ;HWID example
"Fabrikam Laser 9100" =        Laser9000,Fabrik9100_sjkasj                       ;HWID example
"Fabrikam Laser 9000 series" = Laser9000,{E0691E8C-F7CC-456E-A7B5-D1FC19BA2279}  ;PrinterDriverID

[Laser9000]
CopyFiles=Laser9000_FILES

[Laser9000_FILES]
faPDL.gpd
faPDL-pipelineconfig.xml
faPDL-manifest.ini
faPDL.dll

[SourceDisksNames.amd64]
1 = %Location%,,,
2 = %Location%,,,amd64

[SourceDisksNames.x86]
1 = %Location%,,,
2 = %Location%,,,x86

[DestinationDirs]
DefaultDestDir=66000

[SourceDisksFiles]
faPDL.gpd=1
faPDL-pipelineconfig.xml=1
faPDL-manifest.ini = 1
faPDL.dll =2

[Strings]
Location="Fabrikam DVD"

INF-Richtlinien

Die folgende Tabelle zeigt die Liste der druckerspezifischen Anweisungen, die in v4-Drucktreibern und Druckklassentreibern zulässig sind.

Anweisung	BESCHREIBUNG	Beschränkungen	Verbrauch
ClassVer	Wird verwendet, um anzugeben, dass ein Druckerklassentreiber v4 ist.	V4-Drucktreiber müssen ClassVer=4.0 angeben. V3-Drucktreiber geben möglicherweise ClassVer=3.0 an, ist jedoch optional. Derzeit werden keine anderen Werte unterstützt.	ClassVer=4.0

Das DestinationDirs-Schlüsselwort

Der v4-Treiber-INF erfordert, dass DestinationDir für alle Dateien im Paket angegeben ist. Die unterstützten DestinationDir-Werte sind in der folgenden Tabelle aufgeführt.

DestinationDir-ID	BESCHREIBUNG
66000	[Diese Ziel-ID wurde für den v4-Treiber überladen] V4: Dies muss als DefaultDestDir für einen v4-Drucktreiber festgelegt werden. Gibt an, dass die Dateien aus dem Treiberspeicher ausgeführt werden sollen. V3: Dies gibt an, dass Dateien im Verzeichnis \3 installiert werden sollen.
23	V4: Dies muss als DestinationDir für alle Farbprofile festgelegt werden. V3: Farbprofile sollten mit der druckerspezifischen DirID 66003 installiert werden.

INF-Einschränkungen

V4-Drucktreiber dürfen keine anderen druckerspezifischen Anweisungen oder Schlüsselwörter definieren, die in der folgenden Liste aufgeführt sind.

SCHLÜSSELWORT FÜR DIE INF-Datei	Verwendungstyp
AddInterface	Anweisung
AddReg	Anweisung
AddService	Anweisung
BitReg	Anweisung
ClassInstall32	Abschnittstyp
ClassInstall32.Service	Abschnittstyp
ConfigFile	v3 Druckdirektive
CoreDriverDependencies	v3 Druckdirektive
CoreDriverSections	v3 Druckdirektive
DataFile	v3 Druckdirektive
DDInstall.CoInstallers	Abschnittstyp
DDInstall.FactDef	Abschnittstyp
DDInstall.HW	Abschnittstyp
DDInstall.Interfaces	Abschnittstyp
DDInstall.LogConfigOverride	Abschnittstyp
DDInstall.Services	Abschnittstyp
DDInstall.WMI	Abschnittstyp
Defaultinstall	Abschnittstyp
DefaultInstall.Services	Abschnittstyp
DelFiles	Anweisung
DelReg	Anweisung
DelService	Anweisung
DontReflectOffline	Anweisung
DriverFile	v3 Druckdirektive
DriverIsolation	v3 Druckdirektive
FeatureScore	Anweisung
HelpFile	v3 Druckdirektive
Einschließen	Anweisung
Ini2Reg	Anweisung
InterfaceInstall32	Abschnittstyp
LayoutFile	Anweisung
LogConfig	Anweisung
Anforderungen	Anweisung
PackageAware	v3-Druckdirektive
RenFiles	Anweisung
UpdateIniFields	Anweisung
UpdateInis	Anweisung

NTPrint-Verweise

NTPrint-Verweise werden in der Manifestdatei vorgenommen. Die INF-Datei erfordert keine Informationen zu den NTPrint-Verweisen in den Abschnitten DDInstall, CopyFiles oder SourceDisksFiles.

Konfigurationsmodulverweise

Alle Drucktreiber verwenden die gleiche Konfigurationsmodul-Binärdatei (PrintConfig.dll); Es gibt keinen Mechanismus, mit dem ein Treiber das Konfigurationsmodul auswählen kann.

Zugehörige Themen

Informationen zum Erstellen einer INF-Datei für einen einfachen v4-Druckertreiber finden Sie unter Erstellen eines einfachen v4-Druckertreibers.