Ausführen von InfVerif über die Befehlszeile

Dieses Thema beschreibt die Optionen, die beim Ausführen von InfVerif.exe über die Befehlszeile zur Verfügung stehen.

USAGE: InfVerif.exe [/code <error code>] [/v] [[/h] | [/w] | [/u] | [/k]]
                    [/rulever <Major.Minor.Build> | vnext]
                    [/wbuild <Major.Minor.Build>] [/info] [/stampinf]
                    [/l <path>] [/osver <TargetOSVersion>] [/product <ias file>]
                    [/provider <ProviderName>] <files>

/code <error code>
        Display help information for an error code.

/v
        Display verbose file logging details.

/h
        Reports errors using WHQL Signature requirements. (mode)

        This mode uses requirements that always align with the requirements
        to get a WHQL signature, current as of this InfVerif version. These
        requirements may change build-to-build.

        This mode can be combined with '/rulever vnext' to preview proposed
        future requirements.

/w
        Reports errors using Windows Driver requirements. (mode)

/u
        Reports errors using Universal Driver requirements. (mode)

/k
        Reports errors using Declarative Driver requirements. (mode)

/wbuild <Major.Minor.Build>
        For Windows Drivers that have downlevel support, specifies
        the build number where /w should be enforced.
        Defaults to 10.0.17763

/rulever <Major.Minor.Build>
        To use a previous or future version of InfVerif enforcement, specifies
        the build number to use rule enforcement from.
        Defaults to the current InfVerif version

/info
        Displays INF summary information.

/stampinf
        Treat $ARCH$ as a valid architecture, to validate
        pre-stampinf files.

/l <path>
        An inline-annotated HTML version of each INF
        file will be placed in the <path>.

/osver <TargetOsVersion>
        Process the INF for only a specific target OS.
        Formatting is the same as a Models section, i.e. NTAMD64.6.0

/product <ias file>
        Validates all include/needs directives against
        the product definition in the ias file.

/provider <ProviderName>
        Reports an error for INFs not using the specified provider name.

<files>
        A space-separated list of INF files to analyze.
        All files must have .inf extension.
        Wildcards (*) may be used.

Only one mode option may be passed at a time.

Informationen zu Fehlercodes finden Sie unter INF-Validierungsfehler und Warnungen

Die ausführliche Option fügt der Ausgabe eine Zeile hinzu, die angibt, ob die INF gültig ist oder nicht. Bestimmte Argumente werden als Modi markiert, bei denen nur ein Argument übergeben werden soll.

Beispiele für die TargetOSVersion-Formatierung finden Sie im Abschnitt „Anmerkungen“ des Abschnitts INF Manufacturer.

Um mehrere INF-Dateien zu überprüfen, stellen Sie mehrere Dateinamen bereit, oder verwenden Sie einen Platzhalter:

infverif.exe /w test1.inf test2.inf
infverif.exe /w test*.inf

Neu für Windows 10, Version 1703: Die Infooption ist besonders hilfreich, um die INF-Anwendbarkeit zu überprüfen. Sie meldet jede unterstützte Hardware-ID zusammen mit gültiger Architektur und der erforderlichen Mindestversion des Betriebssystems. Sie können /info und /osver zusammen verwenden, um die Anwendbarkeit eines INF für Betriebssystemversionen und -architekturen zu überprüfen.

Neu für Windows 10, Version 1809: Wenn Sie einen Windows-Treiber entwickeln, verwenden Sie infverif /w (idealerweise mit /v), um die Kompatibilität mit dem deklarativen (D) Prinzip der DCH-Entwurfsprinzipien festzulegen. Das Flag /w prüft außerdem, ob die INF die Anforderung Isolierung von Treiberpaketen von Starten Sie mit der Entwicklung von Windows-Treibern erfüllt.

Neu in Windows 11, Version 24H2: Das neue Argument /code wurde eingeführt, um erweiterte Details zu Fehlercodes bereitzustellen. Der neue Modus „infverif /h“ wird eingeführt, um zu bestimmen, ob die INF-Datei die Anforderungen für Hardware Dev Center erfüllt, um ein Treiberpaket zu signieren. Weitere Informationen zu „infverif /h“ finden Sie unter InfVerif /h.

InfVerif- und MSBuild-Aufgaben

MSBuild führt InfVerif automatisch als Aufgabe direkt nach der Stampinf-Aufgabe aus. Sie verwendet die Zielplattform in den Projekteigenschaften (Configuration Properties>-Treibereinstellungen), um die automatische Konfiguration wie folgt durchzuführen:

• Zielplattform = Desktopverwendung InfVerif /h
• Zielplattform = Universelle Verwendung InfVerif /u
• Zielplattform = Windows-Treiber-Verwendung InfVerif /w

Es ist nicht möglich, diesen automatischen Aufruf zu ändern. Wenn Sie weitere oben beschriebene Einstellungen verwenden möchten, können Sie InfVerif entweder als eigenständiges Gerät ausführen oder InfVerif.exe mithilfe eines benutzerdefinierten Ziels in der .vcxproj-Datei aufrufen.