Compartir a través de

Ejecución de InfVerif desde la línea de comandos

  • Artículo

En este tema se enumeran las opciones disponibles al ejecutar InfVerif.exe desde la línea de comandos.

Nota:

InfVerif requiere que cada combinación de ruta de acceso y nombre de archivo tenga menos de 260 caracteres.

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.

Para obtener información sobre los códigos de error, consulte Errores y advertencias de validación de INF.

La opción detallada agrega una línea a la salida que especifica si el INF es válido o no. Algunos argumentos se etiquetan como modos, donde solo se debe pasar uno.

Para obtener ejemplos de formato TargetOSVersion, consulte la sección de Comentarios de la sección Fabricante de INF.

Para validar varios archivos INF, proporcione varios nombres de archivo o use un carácter comodín:

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

Novedades de Windows 10, versión 1703: La opción de información es especialmente útil para comprobar la aplicabilidad de INF. Informa de cada identificador de hardware admitido junto con la arquitectura válida y la versión mínima del sistema operativo. Puede usar /info y /osver juntos para validar la aplicabilidad de un INF en las versiones y arquitecturas del sistema operativo.

Novedades de Windows 10, versión 1809: Si estás desarrollando un controlador de Windows, use infverif /w (idealmente con /v) para determinar la compatibilidad con el principio declarativo (D) de los Principios de diseño de DCH. La marca /w también comprueba si el INF cumple con el requisito de aislamiento del paquete de controladores que se indica en Introducción al desarrollo de controladores de Windows.

Nuevo Windows 11, versión 24H2: el nuevo argumento '/code' se introdujo para proporcionar detalles expandidos sobre un código de error. Se ha introducido el nuevo modo 'infverif /h' para determinar si el archivo INF cumple los requisitos de Centro de desarrollo de hardware para WHQL, para firmar un paquete de controladores. Para obtener más información sobre 'infverif /h', consulte InfVerif /h.

Tareas de InfVerif y MSBuild

MSBuild ejecuta automáticamente InfVerif como una tarea, justo después de la tarea Stampinf. Usa la plataforma de destino de las propiedades del proyecto (Propiedades de configuración->Configuración de controlador) para configurar automáticamente de la siguiente manera:

  • Plataforma de destino = Usos de escritorio InfVerif /h
  • Plataforma de destino = usos universales InfVerif /u
  • Plataforma de destino = el controlador de Windows usa InfVerif /w

No es posible cambiar esa invocación automática. Si desea usar otras opciones de configuración descritas anteriormente, puede ejecutar InfVerif como proceso independiente o llamar a InfVerif.exe mediante un destino personalizado en el archivo .vcxproj.