INF-Validierungsfehler und Warnungen

In diesem Thema werden Treiberinstallationsfehler und Warnungen beschrieben, die beim Ausführen der automatischen INF-Überprüfung von Microsoft Visual Studio oder beim Ausführen des InfVerif-Tools angezeigt werden können.

Ab Visual Studio 2015 mit WDK 10 können beim Erstellen des Treibers die folgenden INF-Dateifehler im Bereich „Fehlerliste“ angezeigt werden. Wenn Sie InfVerif.exe über die Befehlszeile ausführen, zeigt das Tool diese Fehler bei der Eingabeaufforderung oder in der HTML-Version der Ergebnisse an.

Fehlerleitfaden

InfVerif folgt einer allgemeinen Regel: Je niedriger die Fehlernummer ist, desto schwerwiegender ist das Problem. Die meisten Fehlercodes können entweder eine Warnung oder ein Fehler sein, abhängig von den Argumenten, die in InfVerif angegeben werden.

Fehler sollten als „Muss behoben werden“ betrachtet werden.

Warnungen können ignoriert werden, wenn sie vollständig verstanden werden, häufig sind sie jedoch Symptome eines anderen Problems. Beispielsweise könnte eine Warnung, dass ein Abschnitt nicht verwendet wird, ein Symptom einer falsch aufgerufenen INF-Anweisung sein.

Behandeln von Fehlern

Sie müssen alle Fehler beheben, um Treibertests im Hardware Dev Center zu bestehen.

Fehler beziehen sich auf die folgenden Bedingungen:

• Der INF-Parser kann Ihre INF nicht erfolgreich interpretieren
• Der INF-Parser kann die INF nur interpretieren, indem er eine Standardwertannahme (mehrdeutige Syntax) vornimmt.
• Die Argumente für InfVerif geben an, dass ein Regelsatz auf den INF angewendet werden soll (z. B: InfVerif /h)

Es ist zwar nicht erforderlich, die Warnungen zu beheben, bevor Sie Ihren Treiber an das Entwicklungszentrum übermitteln, es wird jedoch empfohlen, sich die Zeit zu nehmen, um das gemeldete Problem zu verstehen. Wenn Sie eine bestimmte Warnung nicht verstehen, verhält sich Ihre INF möglicherweise nicht immer wie erwartet.

Warnungen beziehen sich in der Regel auf:

• eine möglicherweise falsche Syntax, die jedoch gültige Szenarien enthält, wo dies zutreffend ist
• eine Syntax, die für die angegebenen InfVerif-Parameter gültig ist, aber in anderen Modi einen Fehler darstellt, z. B. Treiberisolationsmodus

Fehlercodes

In WDK 10.0.26100.1 (Windows 11, Version 24H2) enthält der InfVerif.exe-Befehl „infverif.exe /code“ dieselben Informationen wie in der folgenden Tabelle gezeigt.

[SourceDisksFiles]
DriverFile.sys=1,x64
[DestinationDirs]
CopyFileSection=13,SubDirectory

[CopyFileSection]
DriverFile.sys

[MyAddReg]
HKR,,DllPath,%SystemRoot%\System32\binary.dll

[MyAddReg]
HKR,,DllPath,%%SystemRoot%%\System32\binary.dll

[DDInstall.Services]
Include=filename.inf
Needs=inf-section-name.Services

AddService = ,2

AddService = MyFilterDriver,, My-Service-Install-Section
AddService = ,2

[DDInstall.Services]
Needs=TargetInstall.Services

[DDInstall.Services]
Needs=TargetInstall.Services

[DDInstall.Services]
Needs=TargetInstall.Services

[DDInstall.Services]
Needs=TargetInstall.Services