Directive INF UpdateInis
Attention
À compter de Windows 11 version 22H2, un package de pilotes utilisant cette directive n’est plus éligible à une signature à partir 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 de ligne par ligne de et vers ces fichiers INI peuvent être spécifiées dans la section update-ini-section.
[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 indiquées dans l’instruction de syntaxe formelle, ainsi que dans les sections définies par l’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 section update-ini peut avoir n’importe quel nombre d’entrées déterminé par l’enregistreur INF, chacun sur une ligne distincte.
Entries
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 en tant que nom de fichier ou en tant que jeton %strkey% défini dans une section Chaînes 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 ini est omise mais qu’une nouvelle entrée 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 l’ini-section donnée, généralement exprimée sous la forme suivante :
"key=value"
La clé et la valeur peuvent être exprimées en tant que jetons %strkey% définis dans une section Chaînes du fichier INF. L’astérisque (*) peut être spécifié en tant que caractère générique pour la clé ou la valeur.
new-ini-entry
Cette valeur facultative spécifie une modification d’une ancienne entrée donnée ou l’ajout d’une nouvelle entrée. Cette valeur peut être exprimée de la même manière que l’ancienne entrée.
flags
Cette valeur facultative contrôle l’interprétation de l’ancienne entrée et/ou de l’entrée new-ini-entry donnée. 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 s’il est omis . Si l’ancienne clé d’entrée d’entrée 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 des 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 sans condition, omettez la valeur d’ancienne entrée de l’entrée dans la section update-ini de l’INF. Pour supprimer sans condition une ancienne entrée ini du fichier INI de destination, omettez la valeur new-ini-entry . |
| 1 | Si l’ancienne entrée (key=value) donnée existe dans les fichiers INI, remplacez-la dans le fichier INI de destination dont la nouvelle entrée est donnée. La clé et la valeur de l’ancienne entrée 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. Dans le cas contraire, les modifications apportées dépendent des correspondances trouvées dans les fichiers INI pour les clés d’ancienne entrée et de new-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, remplacez l’ancienne entrée par la nouvelle entrée ini dans le fichier INI de destination, puis supprimez la nouvelle entrée superflue de ce fichier INI. (2) Si la clé de l’ancienne entrée ini existe dans les fichiers INI, mais que la clé de l’entrée new-ini ne le fait pas, remplacez la clé old-ini-entry par celle du nouveau-ini-entry dans le fichier INI de destination, mais laissez la valeur de l’ancienne entrée ini 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 de l’ancienne entrée et de l’entrée new-ini, comme suit : (1) Si la valeur key=de l’ancienne entrée ini existe dans les fichiers INI, mais que la valeur key=de l’entrée new-ini-, remplacez l’ancienne entrée ini par l’entrée new-ini dans le fichier INI de destination, puis supprimez l’entrée superflue de ce fichier INI. (2) Si la clé=valeur de l’ancienne entrée ini existe dans les fichiers INI, mais que le nouveau-ini-entry ne le fait pas, remplacez l’ancienne entrée par l’entrée new-ini dans le fichier INI de destination, mais laissez la valeur de l’ancien-ini-entry inchangé. |
Notes
Un nom de section update-ini donné doit être unique dans le fichier INF et doit suivre les règles générales de définition des noms de section. Pour plus d'informations sur ces règles, voir Règles générales de syntaxe pour les fichiers INF.
L’inf fournit le chemin 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 n’est pas dans le répertoire racine (ou 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 dans la section Version du fichier INF.
Tout nom de fichier spécifié dans une ancienne entrée ou new-ini-entry doit désigner le répertoire de destination qui contient ce fichier. Un tel 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 des listes de valeurs dirid possibles, consultez Utilisation de Dirids.