Partager via

Options de commande Stampinf

  • Article

Stampinf est un outil en ligne de commande qui met à jour les directives courantes du fichier INF.

Stampinf -f filename 
[-s section] 
[-d [date | *]] 
[-a [architecture]] 
[-c catalogfile]
[-v [time | *]]
[-k version] 
[-u version]
[-i path]
[-n]

Paramètres

-f Fichier
Spécifie le fichier INF ou INX à traiter.

-s, section
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.

-d [ date | \]
Spécifie la date écrite dans la directive INF DriverVer. Le format de la date est mois/date/année (par exemple, -d 10/20/2011).

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

Si le paramètre -d n’est pas spécifié ou est spécifié sans aucune option, 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.

-a [ architecture ]
Spécifie la chaîne d’architecture pour remplacer la variable $ARCH$ utilisée dans les fichiers INX. La variable $ARCH$ est utilisée pour personnaliser une décoration TargetOSVersion dans une section fabricant INF et son nom de section respectif sur une plateforme spécifique. Pour plus d’informations sur la variable $ARCH$, consultez Utilisation de fichiers INX pour créer des fichiers INF.

Les valeurs de la chaîne d’architecture sont x86, 64 (pour les plateformes itanium) et x64 (pour les plateformes amd64).

Si le paramètre -a n’est pas spécifié ou est spécifié sans aucune option, Stampinf utilise la valeur spécifiée par la variable d’environnement de plateforme, qui est définie dans la fenêtre d’environnement de build.

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

-v [ heure | *]
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.

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

Si le paramètre -v n’est pas spécifié ou est spécifié sans aucune option, 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.

-k Version
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).

-u Version
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).

-n
Affiche une sortie Stampinf détaillée.

-i path
Spécifie l’emplacement du fichier Ntverp.h. Le chemin représente un emplacement complet du répertoire qui contient Ntverp.h

Commentaires

La valeur de date que Stampinf place dans la directive INF DriverVer n’est pas basée sur le temps universel coordonné (UTC), également appelé Heure moyenne de Greenwich. Toutefois, Inf2Cat interprète la valeur de date de cette directive INF comme valeur UTC. Cela peut entraîner des erreurs si la valeur de date locale utilisée par Stampinf est interprétée par Inf2Cat comme valeur UTC pour la date de demain. Pour éviter ce problème, effectuez l’une des opérations suivantes :

  • Définissez la variable d’environnement STAMPINF_DATE sur la valeur de date UTC appropriée. Exécutez maintenant Stampinf sans spécifier le paramètre -d . Cela indique à Stampinf d’utiliser la valeur de date spécifiée par la variable d’environnement STAMPINF_DATE. À présent, Stampinf et Inf2Cat utilisent UTC.
  • Modifiez les paramètres du projet de package de pilotes afin que Inf2Cat définit /uselocaltime. Pour ce faire, utilisez les propriétés de configuration-Inf2Cat-General-Use>>> Local Time. À présent, Stampinf et Inf2Cat utilisent l’heure locale.

Lorsque vous développez votre pilote, vous pouvez définir la variable d’environnement PRIVATE_DRIVER_PACKAGE. Lorsque cette variable est définie, Stampinf définit la date et la version utilisées pour la directive INF DriverVer à la date et à l’heure actuelles, quels que soient les paramètres de ligne de commande. En outre, Stampinf définit la directive CatalogFile . Stampinf écrit CatalogFile=delta.cat dans la section Version INF, sauf si un catalogue a déjà été spécifié avec l’option de commande -c .

Tapez la commande suivante dans une fenêtre de build pour activer ce mode de développement :

set PRIVATE_DRIVER_PACKAGE=1