Directive INF UpdateIniFields

Article
02/02/2024

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 UpdateIniFields fait référence à une ou plusieurs sections nommées dans lesquelles des modifications affinées dans les lignes d’un fichier INI peuvent être spécifiées.

[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)

UpdateIniFields=update-inifields-section[,update-inifields-section]...

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

[update-inifields-section]
 
ini-file,ini-section,profile-name[,old-field][,new-field][,flags]
...

Une section update-inifields peut avoir un 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 d’un 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 les fichiers INI donnés qui contient la ligne à modifier.

profile-name
Spécifie le nom de la ligne à modifier dans la section INI donnée. Au moins une des entrées de champ ancien et/ou nouveau champ doit être spécifiée pour effectuer une modification de cette ligne.

old-field
Spécifie un champ existant dans la ligne donnée. Si new-field est omis de cette entrée de section, ce champ est supprimé de la ligne donnée. Sinon, la valeur new-field donnée doit remplacer ce champ.

new-field
Spécifie un remplacement pour un ancien champ donné ou, si l’ancien champ est omis, un ajout à la ligne donnée.

flags
Spécifie (dans le bit 0) comment interpréter l’ancien-champ donné et/ou le nouveau-champ si l’un ou les deux contiennent un astérisque (*) et/ou (dans le bit 1) le caractère de séparation à utiliser lors de l’ajout d’un nouveau champ donné à la ligne donnée, comme suit :

Bit zéro = 0
Interpréter littéralement tout astérisque (*) dans l’ancien champ et/ou les entrées de nouveau champ spécifiés, et non comme un caractère de carte générique, lors de la recherche d’une correspondance dans la ligne donnée du fichier INI. Il s’agit de la valeur par défaut.

Bit zéro = 1
Interpréter un astérisque (*) dans l’ancien champ et/ou les entrées de nouveau champ spécifiés comme caractère carte générique lors de la recherche d’une correspondance dans la ligne donnée du fichier INI.

Bit 1 = 0
Utilisez un caractère d’espace comme séparateur lors de l’ajout de l’entrée de nouveau champ spécifiée à la ligne donnée du fichier INI. Il s’agit de la valeur par défaut.

Bit 1 = 1
Utilisez une virgule (,) comme séparateur lors de l’ajout de l’entrée de nouveau champ spécifiée à la ligne donnée du fichier INI.

Remarques

La directive UpdateIniFields n’est presque jamais spécifiée dans les fichiers INF pour les installations sur Windows, car il n’est pas nécessaire d’avoir des fichiers INI sur leur support de distribution. Toutefois, la directive UpdateIniFields 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 nom update-inifields-section doit être unique au fichier INF. Chaque nom de section créé par l’enregistreur INF 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.

Contrairement à une section référencée par la directive UpdateInis , une section référencée par UpdateIniFields remplace, ajoute ou supprime des parties d’une ligne dans une ligne de fichier INI existante au lieu d’affecter la valeur entière d’une ligne particulière. Au moins une des valeurs de l’ancien champ et/ou du nouveau champ doit être spécifiée dans chaque entrée de section.

Tous les commentaires d’une ligne de fichier INI à modifier sont supprimés, car ils peuvent ne pas être applicables après les modifications apportées conformément à cette section. Lorsque vous recherchez des champs dans la ligne dans les fichiers INI, les espaces, les onglets et les virgules sont interprétés comme des séparateurs de champs. Toutefois, un espace est utilisé comme séparateur par défaut lorsqu’un nouveau champ est ajouté à une ligne.

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.