Directive INF Ini2Reg
Attention
À partir de la version 22H2 de Windows 11, un package de pilotes utilisant cette directive n’est plus éligible à une signature du Hardware Developer Center.
Les packages de pilotes universels et les pilotes Windows ne peuvent pas utiliser cette directive.
Une directive Ini2Reg fait référence à une ou plusieurs sections nommées dans lesquelles des lignes ou sections d’un fichier INI fourni sont déplacées dans le registre. Cela crée ou remplace une ou plusieurs entrées de valeur sous une clé spécifiée.
[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)
Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
Chaque section nommée référencée par une directive Ini2Reg a la forme suivante :
[ini-to-registry-section]
ini-file,ini-section,[ini-key],reg-root,subkey[,flags]
...
Une ini-to-registry-section peut avoir un nombre d’entrées déterminé par l’auteur de l’INF, chaque entrée figurant sur une ligne distincte.
Entries
ini-file
Spécifie le nom d’un fichier INI fourni sur le support source. Cette valeur peut être exprimée sous forme de filename ou comme 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é qui contient les informations du registre à copier.
ini-key
Spécifie le nom de la clé dans le fichier INI à copier dans le registre. Si cette valeur est omise, l’ensemble de la ini-section doit être transféré dans la sous-clé de registre spécifiée.
reg-root
Identifie la racine de l’arborescence du registre pour d’autres valeurs fournies dans cette entrée. Pour plus de détails, veuillez consulter la section de référence pour la directive AddReg.
sous-clé
Identifie la sous-clé qui doit recevoir la valeur, exprimée soit comme un jeton %strkey% défini dans une section Strings de l’INF, soit comme un chemin de registre explicite (key1\key2\key3...) à partir de la reg-root donnée.
flags
Spécifie (dans le bit 0) comment gérer le fichier INI après le transfert des informations données dans le registre et/ou (dans le bit 1) s’il faut écraser les informations existantes dans le registre, comme suit :
Bit zéro = 0
Ne pas supprimer les informations données du fichier INI après les avoir copiées dans le registre. Il s’agit de la valeur par défaut.
Bit zéro = 1
Supprimer les informations données du fichier INI après les avoir déplacées dans le registre.
Bit un = 0
Si la sous-clé spécifiée existe déjà dans le registre, ne pas transférer les informations fournies par l’INI dans cette sous-clé. Sinon, créer la sous-clé spécifiée dans le registre avec ces informations fournies par l’INI comme entrée de valeur. Il s’agit de la valeur par défaut.
Bit un = 1
Si la sous-clé spécifiée existe déjà dans le registre, remplacer son entrée de valeur par les informations fournies par l’INI.
Notes
La directive Ini2Reg est valide dans l’une des sections indiquées dans l’énoncé de syntaxe formel. Cette directive est également valide dans les sections définies par l’auteur de l’INF référencées par une directive AddInterface ou référencées dans une section InterfaceInstall32.
Si un fichier INF est utilisé pour installer des périphériques sur Windows XP et les versions ultérieures de Windows, le fichier INF ne doit pas contenir de directives Ini2Reg. Les fichiers INF qui contiennent des directives Ini2Reg ne réussiront pas le test du logo « Designed For Windows », ne recevront pas de signature numérique et ne seront donc pas fiables par Windows (veuillez consulter la section Comment Windows sélectionne les pilotes).
Chaque nom de ini-to-registry-section doit être unique dans le fichier INF. Chaque nom de section créé par l’auteur de l’INF doit être unique dans le fichier INF et doit suivre les règles générales pour définir 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-file donné sur le support de distribution de l’une des manières suivantes :
Dans les fichiers INF fournis par les IHV/FEO, en utilisant les sections SourceDisksNames et, éventuellement, SourceDisksFiles de cet INF pour spécifier explicitement le chemin 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 dans la section Version du fichier INF.