Inf Ini2Reg, directive

Article
07/20/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 Ini2Reg fait référence à une ou plusieurs sections nommées dans lesquelles les 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 section ini-to-registry peut avoir n’importe quel nombre d’entrées déterminées 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. 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é qui contient les informations de 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 section ini doit être transféré vers la sous-clé de Registre spécifiée.

reg-root
Identifie la racine de l’arborescence du Registre pour les autres valeurs fournies dans cette entrée. Pour plus d’informations, consultez la référence de la directive AddReg.

Sous-clé
Identifie la sous-clé à recevoir la valeur, exprimée sous la forme d’un jeton %strkey% défini dans une section Strings de l’INF ou en tant que chemin de Registre explicite (clé1\key2\key3...) à partir de la reg-root donnée.

flags
Spécifie (en bit 0) comment gérer le fichier INI après avoir transféré les informations données vers le Registre et/ou (au bit 1) s’il faut remplacer les informations de Registre existantes, comme suit :

Bit zéro = 0
Ne supprimez pas 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
Supprimez les informations données du fichier INI après l’avoir déplacé dans le Registre.

Bit 1 = 0
Si la sous-clé spécifiée existe déjà dans le Registre, ne transférez pas les informations fournies par INI dans cette sous-clé. Sinon, créez la sous-clé spécifiée dans le Registre avec ces informations fournies par INI comme entrée de valeur. Il s’agit de la valeur par défaut.

Bit 1 = 1
Si la sous-clé spécifiée existe déjà dans le Registre, remplacez son entrée de valeur par les informations fournies par INI.

Remarques

La directive Ini2Reg est valide dans l’une des sections indiquées dans l’instruction de syntaxe formelle. Cette directive est également valide 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 .

Si un fichier INF est utilisé pour installer des appareils 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 passeront pas les tests de logo « Conçu pour Windows », ne recevront pas de signature numérique et ne seront donc pas approuvés par Windows (voir Comment Windows sélectionne les pilotes).

Chaque nom de section ini-to-registry 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.

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, éventuellement, 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.