Propriétés Stampinf pour les projets de pilote

  • Article

Définit les propriétés de l’outil Stampinf . Vous pouvez utiliser Stampinf pour mettre à jour les directives de fichier INF et INX courantes lorsque vous générez le pilote.

Définition des propriétés Stampinf pour les projets de pilotes

  1. Ouvrez les pages de propriétés de votre projet de pilote. Sélectionnez et maintenez enfoncé (ou cliquez avec le bouton droit) le projet de pilote dans Explorateur de solutions, puis sélectionnez Propriétés.
  2. Dans les pages de propriétés du projet de pilote, sélectionnez Propriétés de configuration, puis Stampinf.
  3. Définissez les propriétés du projet.

Si vous souhaitez ajouter cette page de propriétés à votre projet, afin de pouvoir exécuter Stampinf pendant le processus de génération, consultez l’environnement de build WDK et Visual Studio et la tâche Stampinf.

Option Stampinf Description

Activer l’architecture

Active le remplacement de la variable $ARCH$ utilisée dans les fichiers INX. Si elle est activée, la valeur spécifiée pour Architecture est utilisée. Si aucune valeur n’est spécifiée, la variable $ARCH$ est supprimée. Par exemple, « Standard.NT$ARCH$ » devient « Standard.NT ».

Architecture

Spécifie la chaîne d’architecture pour remplacer la variable $ARCH$ utilisée dans les fichiers INX. La valeur par défaut est $(InfArch), une macro qui sélectionne la configuration active actuelle dans Visual Studio. Les valeurs possibles incluent x86, x64. Ce paramètre équivaut à spécifier l’option Stampinf -a [architecture].

Activer VersionStamp

Active l’horodatage de version. Si cette option est activée, le numéro de version du pilote ne doit pas être vide. Le numéro de version du pilote spécifie l’heure écrite dans la directive INF DriverVer pour le numéro de version. Si cette option n’est pas activée, consultez la description du comportement par défaut de cette option sous Numéro de version du pilote.

Numéro de version du pilote

Spécifie l’heure écrite dans la directive INF DriverVer pour le numéro de version. Le format de l’heure est hours.minutes.seconds.millisecondes (par exemple, 11.30.20.15). Cette option est utile pendant le développement, car elle offre un moyen pratique d’augmenter le numéro de version du pilote. Ce paramètre équivaut à spécifier l’option Stampinf -v [ heure| ].

Pour utiliser l’heure actuelle, spécifiez un astérisque () avec ce paramètre.

Comportement par défaut :

Si le numéro de version du pilote n’est pas spécifié ou si l’option Activer VersionStamp n’est pas spécifiée ou non spécifiée, Stampinf utilise l’une des valeurs de numéro de version suivantes :

  • Si la variable d’environnement STAMPINF_VERSION est définie, Stampinf utilise la valeur du numéro de version spécifiée par cette variable d’environnement.

  • Si la variable d’environnement STAMPINF_VERSION n’est pas spécifiée, Stampinf extrait le numéro de version du fichier ntverp.h.

Notez par défaut que la variable d’environnement STAMPINF_VERSION n’est pas définie lorsque vous générez un pilote, sauf si vous le définissez comme variable d’environnement système. Pour spécifier cette variable d’environnement dans l’environnement de build Visual Studio, consultez Guide pratique pour utiliser des variables d’environnement dans une build.

Activer DateStamp

Active l’horodatage. Si cette option est activée, la date de directive de version du pilote ne doit pas être vide. Si cette option n’est pas activée, consultez la description du comportement par défaut de cette option sous La date de la directive de version du pilote.

Date de directive de version du pilote

Spécifie la date écrite dans la directive INF DriverVer. Le format de la date est l’année de date/du mois/(par exemple, 10/20/2011).

Pour utiliser la date actuelle, spécifiez un astérisque () avec ce paramètre.

Comportement par défaut :

Si le paramètre Date de la directive de version du pilote n’est pas spécifié ou si l’option Activer DateStamp n’est pas spécifiée ou non spécifiée, Stampinf utilise l’une des valeurs de date suivantes :

  • Si la variable d’environnement STAMPINF_DATE est définie, Stampinf utilise la valeur de date spécifiée par cette variable d’environnement.

  • Si la variable d’environnement STAMPINF_DATE n’est pas spécifiée, Stampinf utilise la date actuelle.

Ce paramètre équivaut à spécifier l’option Stampinf -d [date|].

Notez par défaut que la variable d’environnement STAMPINF_DATE n’est pas définie lorsque vous générez un pilote, sauf si vous le définissez comme variable d’environnement système. Pour spécifier cette variable d’environnement dans l’environnement de build Visual Studio, consultez Guide pratique pour utiliser des variables d’environnement dans une build.

Section De la directive de version du pilote

Spécifie la section INF dans laquelle placer la directive INF DriverVer. L’emplacement par défaut de cette directive est la section Version INF.

Ce paramètre équivaut à spécifier la section -s de l’option Stampinf.

Numéro de version KMDF

Spécifie la version de KMDF dont dépend ce pilote. Cela permet de personnaliser le nom du co-programme d’installation KmdfLibraryVersion et KMDF dans le fichier INF. Cette option remplace les mots clés $KMDFVERSION$ et $KMDFCOINSTALLERVERSION$ dans le fichier INF. La chaîne a le format suivant :

<>major_version.<minor_version>

Par exemple, si vous spécifiez 1.5 comme chaîne de version, les valeurs 1.5 et 01005 sont utilisées pour les deux mots clés (respectivement).

Ce paramètre équivaut à spécifier l’option Stampinf -k KMDFversion.

Numéro de version UMDF

Spécifie la version de UMDF dont dépend ce pilote. Cette option est utilisée pour spécifier le nom de co-programme d’installation UmdfLibraryVersion et UMDF dans le fichier INF. La version spécifiée remplace les mots clés $UMDFVERSION$ et $UMDFCOINSTALLERVERSION$ dans le fichier INF. La chaîne de version a le format suivant :

<>major_version.<>minor_version.<service_version>

(où <> service_version est généralement zéro).

Par exemple, si vous spécifiez 1.5.0 comme chaîne de version, les valeurs 1.5.0 et 01005 sont utilisées pour les mots clés principaux et mineurs (respectivement).

Ce paramètre équivaut à spécifier l’option Stampinf -u UMDFversion.

Nom du fichier catalogue

Spécifie la valeur écrite dans la directive CatalogFile dans la section Version INF. Par défaut, la directive CatalogFile n’est pas écrite.

Ce paramètre équivaut à spécifier l’option Stampinf -c catalogfile.

Verbose

Affiche une sortie Stampinf détaillée.

Ce paramètre équivaut à spécifier l’option Stampinf -n .

Chemin d’en-tête de version

Spécifie l’emplacement du fichier Ntverp.h. Le chemin d’accès représente l’emplacement complet du répertoire contenant Ntverp.h.

Ce paramètre équivaut à spécifier l’option Stampinf -i path.