Share via

Exécution d’InfVerif à partir de la ligne de commande

  • Article

Cette rubrique répertorie les options disponibles lorsque vous exécutez InfVerif.exe depuis la ligne de commande.

Remarque

InfVerif exige que chaque chemin combiné et nom de fichier soit inférieur à 260 caractères.

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.

Pour plus d’informations sur les codes d’erreur, veuillez consulter la rubrique Erreurs et Avertissements de Validation INF.

L’option en clair (verbose) ajoute une ligne à la sortie qui spécifie si l’INF est valide ou non. Certaines arguments sont marquées comme des modes, où seul l’un d’eux doit être passé.

Pour voir des exemples de formatage de VersionOSCible, veuillez consulter la section Remarques dans la section Fabricant INF.

Pour valider plusieurs fichiers INF, fournissez plusieurs noms de fichiers ou utilisez un caractère générique (wildcard) :

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

Nouveauté pour Windows 10, version 1703 : L’option info est particulièrement utile pour vérifier l’applicabilité de l’INF. Elle signale chaque ID de matériel pris en charge avec l’architecture valide et la version minimale du système d’exploitation. Vous pouvez utiliser /info et /osver ensemble pour valider l’applicabilité d’un INF sur différentes versions du système d’exploitation et architectures.

Nouveauté de Windows 10, version 1809 : Si vous développez un Pilote Windows, utilisez infverif /w (idéalement avec /v) pour déterminer la compatibilité avec le principe déclaratif (D) des Principes de conception DCH. L’indicateur /w vérifie également si l’INF est conforme à l’exigence d’isolation du package de pilotes de Prise en main des pilotes Windows.

Nouveauté à partir de la version de Windows Insider Preview build 26080 : Le nouvel argument « /code » a été introduit pour fournir des détails étendus sur un code d’erreur. Le nouveau mode « infverif /h » est introduit pour déterminer si le fichier INF répond aux exigences du Centre de développement matériel pour signer un package de pilotes WHQL. Pour plus de détails sur « infverif /h », veuillez consulter la section InfVerif /h.

InfVerif et les tâches MSBuild

MSBuild exécute automatiquement InfVerif en tant que tâche, juste après la tâche Stampinf. Il utilise la Plateforme Cible dans les propriétés du projet (Propriétés de Configuration->Paramètres du Pilote) pour auto-configurer comme suit :

  • Plateforme Cible = Bureau utilise InfVerif /h
  • Plateforme Cible = Universel utilise InfVerif /u
  • Plateforme Cible = Pilote Windows utilise InfVerif /w

Il n’est pas possible de changer cette invocation automatique. Si vous souhaitez utiliser d’autres paramètres décrits ci-dessus, vous pouvez soit exécuter InfVerif en tant qu’application autonome, soit appeler InfVerif.exe en utilisant une cible personnalisée dans le fichier .vcxproj.