Directive INF UpdateInis

Article
07/17/2023

Attention

À compter de Windows 11 version 22H2, un package de pilotes utilisant cette directive n’est plus éligible pour une signature du Centre de développement matériel.

Les packages de pilotes universels et les pilotes Windows ne peuvent pas utiliser cette directive.

Une directive UpdateInis fait référence à une ou plusieurs sections nommées, en spécifiant un fichier INI à partir duquel une section ou une ligne particulière doit être lue et appliquée à un fichier INI existant du même nom sur l’ordinateur cible. Si vous le souhaitez, les modifications ligne par ligne depuis et vers ces fichiers INI peuvent être spécifiées dans la section update-ini.

[DDInstall] | 
[DDInstall.CoInstallers] | 
[ClassInstall32] | 
[ClassInstall32.ntx86] | 
[ClassInstall32.ntia64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntamd64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntarm] | (Windows 8 and later versions of Windows)
[ClassInstall32.ntarm64] (Windows 10 version 1709 and later versions of Windows)

UpdateInis=update-ini-section[,update-ini-section]...

Cette directive n’est presque jamais spécifiée dans les fichiers INF pour l’installation sur Windows, en raison de l’absence de nécessité pour les fichiers INI. Toutefois, la directive UpdateInis est valide dans l’une des sections affichées dans l’instruction de syntaxe formelle, ainsi que dans les sections définies par un enregistreur INF référencées par une directive AddInterface ou référencées dans une section InterfaceInstall32 .

Chaque section nommée référencée par une directive UpdateInis a la forme suivante :

[update-ini-section]
 
ini-file,ini-section[,old-ini-entry][,new-ini-entry][,flags]
...

Une update-ini-section peut avoir n’importe quel nombre d’entrées déterminé par INF-writer, chacune sur une ligne distincte.

Entrées

ini-file
Spécifie le nom d’un fichier INI fourni sur le média source et, implicitement, celui du fichier INI à mettre à jour sur l’ordinateur cible. Cette valeur peut être exprimée sous la forme d’un nom de fichier ou d’un jeton %strkey% défini dans une section Strings du fichier INF.

ini-section
Spécifie le nom de la section dans le fichier INI donné. Si les deux valeurs suivantes sont spécifiées, cette section contient une entrée à modifier. Si une ancienne entrée d’ini est omise mais qu’une entrée new-ini est fournie, la nouvelle entrée doit être ajoutée à mesure que cette section est lue.

old-ini-entry
Cette valeur facultative spécifie le nom d’une entrée dans la section ini donnée, généralement exprimée sous la forme suivante :

"key=value"

La clé et la valeur peuvent être exprimées sous la forme de jetons %strkey% définis dans une section Chaînes du fichier INF. L’astérisque (*) peut être spécifié en tant que carte générique pour la clé ou la valeur.

new-ini-entry
Cette valeur facultative spécifie une modification d’une ancienne entrée d’ini donnée ou l’ajout d’une nouvelle entrée. Cette valeur peut être exprimée de la même manière que old-ini-entry.

flags
Cette valeur facultative contrôle l’interprétation de l’ancien ini-entry et/ou de l’entrée new-ini donnés. L’entrée d’indicateurs peut être l’une des valeurs numériques suivantes :

Valeur	Signification
0	Il s’agit de la valeur par défaut de l’entrée d’indicateurs si elle est omise . Si la clé old-ini-entry donnée est présente dans les fichiers INI, remplacez cette clé=value par l’entrée new-ini donnée. Seules les clés dans les fichiers INI doivent correspondre. La valeur correspondante de chaque clé de ce type est ignorée. Pour ajouter une entrée new-ini au fichier INI de destination de manière inconditionnelle, omettez la valeur old-ini-entry de l’entrée dans la section update-ini de l’INF. Pour supprimer une ancienne entrée d’ini du fichier INI de destination de manière inconditionnelle, omettez la valeur new-ini-entry .
1	Si l’ancienne entrée d’ini donnée (key=value) existe dans les fichiers INI, remplacez-la dans le fichier INI de destination qui a l’entrée new-ini donnée. La clé et la valeur de l’ancienne entrée d’ini spécifiée doivent correspondre à celles des fichiers INI pour qu’un tel remplacement soit effectué, et pas seulement leurs clés comme pour la valeur des indicateurs précédents .
2	Si la clé spécifiée pour old-ini-entry est introuvable dans le fichier INI de destination, ne faites rien. Sinon, les modifications apportées dépendent des correspondances trouvées dans les fichiers INI pour les clés données de l’ancien ini-entry et du nouvel ini-entry, comme suit : (1) Si la clé de l’ancienne entrée ini existe dans les fichiers INI, mais que la clé de l’entrée new-ini est également présente, remplacez l’ancienne entrée ini par l’entrée new-ini dans le fichier INI de destination, puis supprimez l’entrée nouvelle ini superflue de ce fichier INI. (2) Si la clé de l’ancien-ini-entry existe dans les fichiers INI, mais que la clé de l’entrée new-ini ne l’est pas, remplacez la cléd’entrée old-ini par celle de l’entrée new-ini dans le fichier INI de destination, mais laissez la valeur de l’ancien-ini-entry inchangée.
3	Si la clé et la valeur spécifiées pour old-ini-entry sont introuvables dans les fichiers INI, ne faites rien. Dans le cas contraire, les modifications apportées dépendent des correspondances trouvées dans les fichiers INI pour les clés et valeurs données de l’ancien-ini-entry et du nouveau-ini-entry, comme suit : (1) Si la key=value de l’ancien-ini-entry existe dans les fichiers INI, mais que la valeur key=value de la new-ini-entry, remplacez l’ancien-ini-entry par l’entrée new-ini dans le fichier INI de destination, puis supprimez l’entrée nouvelle-ini superflue de ce fichier INI. (2) Si la clé=valeur de l’ancien-ini-entry existe dans les fichiers INI, mais que l’entrée new-ini ne le fait pas, remplacez l’ancien-ini-entry par l’entrée new-ini dans le fichier INI de destination, mais laissez la valeur de l’ancien-ini-entry inchangée.

Remarques

Un nom de section update-ini donné doit être unique dans le fichier INF et respecter les règles générales de définition des noms de section. Pour plus d’informations sur ces règles, consultez Règles de syntaxe générales pour les fichiers INF.

L’inf fournit le chemin d’accès complet du fichier ini donné sur le support de distribution de l’une des manières suivantes :

Dans les fichiers INF fournis par IHV/OEM, en utilisant les sections SourceDisksNames et SourceDisksFiles de cet INF pour spécifier explicitement le chemin d’accès complet de chaque fichier source nommé qui ne se trouve pas dans le répertoire racine (ou les répertoires) sur le support de distribution.
Dans les fichiers INF fournis par le système, en fournissant un ou plusieurs fichiers INF supplémentaires, identifiés dans l’entrée LayoutFile de la section Version du fichier INF.

Tout nom de fichier spécifié dans une ancienne entrée-ini ou new-ini-entry doit désigner le répertoire de destination qui contient ce fichier. Ce chemin d’accès au répertoire de destination d’un nom de fichier dans une entrée update-ini-section doit être spécifié en tant que dirid. Pour obtenir la liste des valeurs dirid possibles, consultez Utilisation de Dirids.