Tâche Stampinf

Le Kit de pilotes Windows (WDK) fournit la tâche StampInf afin que vous puissiez exécuter l’outil stampinf.exe lorsque vous générez votre pilote à l’aide de MSBuild. Pour plus d’informations sur l’outil stampinf.exe, consultez Stampinf.

L’élément Inf envoie les paramètres de la tâche StampInf. Les métadonnées d’élément pour stampinf sont accessibles à l’aide de l’élément Inf dans les fichiers projet.

L’exemple suivant montre comment modifier les métadonnées dans le fichier .vcxproj.

<ItemGroup>
    <Inf Include="a.inf">
      <SpecifyArchitecture>true</SpecifyArchitecture>
      <Architecture>x86</Architecture>
    </Inf>
    <Inf Include="b.inf">
      <SpecifyArchitecture>false</SpecifyArchitecture>
      <Architecture>amd64</Architecture>
    </Inf>
</ItemGroup>

L’exemple suivant montre l’appel de ligne de commande :

stampinf.exe –a "x86" a.inf
stampinf.exe b.inf

Dans l’exemple ci-dessus, MSBuild appelle stampinf.exe sur a.inf et b.inf, mais avec différents ensembles de paramètres. Dans le cas de b.inf, même si les métadonnées d’architecture sont spécifiées, les métadonnées SpecifyArchitecture ont la valeur false. Par conséquent, le commutateur –a n’est pas activé sur la ligne de commande. Si vous définissez ces métadonnées sur TRUE, cela active –a amd64 sur la ligne de commande. De cette façon, vous pouvez simplement basculer ces métadonnées et ne pas avoir à modifier les métadonnées d’architecture elles-mêmes.

Paramètre de tâche StampInf Métadonnées d’élément Commutateur d’outils
Source

Paramètre ITaskItem obligatoire. Spécifie une liste de fichiers sources.

%(Inf.OutputPath)%(Inf.FileName).inf -f[source]
SpecifyArchitecture

Cela active le commutateur -a s’il est défini sur true.

%(Inf.SpecifyArchitecture)
Architecture

Paramètre de chaîne facultatif. Spécifie l’architecture de plateforme cible.

%(Inf.Architecture) -a[architecture]
CatalogFile

Paramètre de chaîne facultatif. Spécifie la directive de fichier catalogue dans la section version INF.

%(Inf.CatalogFileName) -c<catalogFile>
SpecifyDriverVerDirectiveDate

Cela active le commutateur –d s’il est défini sur true.

%(Inf.SpecifyDriverVerDirectiveDate)
DriverVerDirectiveDate

Chaîne facultative

%(Inf.DateStamp) -D[date|]
DriverVerDirectiveSection

Paramètre de chaîne facultatif. Spécifie la section INF dans laquelle la directive INF DriverVer doit être placée.

%(Inf.DriverVersionSectionName) -s
SpecifyDriverVerDirectiveVersion

Cela active le commutateur –v s’il est défini sur true.

%(Inf.SpecifyDriverDirectiveVersion)
DriverVerDirectiveVersion

Paramètre de chaîne facultatif. Spécifie le numéro de version dans la directive du pilote.

%(Inf.TimeStamp) -v[time|]
KmdfVersion

Paramètre de chaîne facultatif. Spécifie la version de KMDF dont dépend ce pilote.

%(Inf.KmdfVersionNumber) -k<version>
MinimalRebuildFromTracking

Paramètre booléen facultatif. Si la valeur est true, une build incrémentielle suivie est effectuée. Sinon, une reconstruction est effectuée.

%(Inf.MinimalRebuildFromTracking)
ToolPath

Paramètre de chaîne facultatif. Vous permet de spécifier le chemin d’accès complet au dossier où se trouve l’outil.

$(StampInfToolPath)
TrackerLogDirectory

Paramètre de chaîne facultatif. Spécifie un répertoire de journaux pour que le suivi écrive des tlogs.

%(Inf.StampInfTrackerLogDirectory)
TrackFileAccess

Paramètre booléen facultatif. Si la valeur est true, effectue le suivi des modèles d’accès aux fichiers pour cette tâche.

$(TrackFileAccess)
UmdfVersion

Paramètre de chaîne facultatif. Spécifie la version d’UMDF dont dépend ce pilote.

%(Inf.UmdfVersionNumber) -u<version>
Verbosité

Paramètre booléen facultatif. Active le détail de la sortie Stampinf.

%(Inf.EnableVerbose) -n