Directive INF ProfileItems
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 ProfileItems est utilisée dans une section INF DDInstall pour lister une ou plusieurs sections d’éléments de profil contenant des éléments ou des groupes à ajouter ou à supprimer du menu Démarrer.
[DDInstall]
ProfileItems=profile-items-section[,profile-items-section]...
...
Chaque section nommée référencée par une directive ProfileItems a la forme suivante :
[profile-items-section]
Name=link-name[,name-attributes]
CmdLine=dirid,[subdir],filename
[SubDir=path]
[WorkingDir=wd-dirid,wd-subdir]
[IconPath=icon-dirid,[icon-subdir],icon-filename]
[IconIndex=index-value]
[HotKey=hotkey-value]
[Infotip=info-tip]
[DisplayResource="ResDllPath\ResDll",ResID]
Cette directive est prise en charge dans Windows XP et les versions ultérieures de Windows.
Entries
Nom=nom-lien[,attributs-nom]
Le nom-lien spécifie le nom du lien pour l’élément ou le groupe du menu, sans l’extension .lnk. Cette valeur peut être une chaîne ou un jeton %strkey% qui est défini dans une section Strings du fichier INF. Si une entrée DisplayResource n’est pas spécifiée, nom-lien est également la chaîne d’affichage.
La valeur optionnelle attributs-nom spécifie un ou plusieurs indicateurs qui affectent l’opération sur l’élément du menu. Cette valeur est exprimée comme un masque de bits OU d’indicateurs définis par le système. Les indicateurs possibles incluent :
0x00000001 (FLG_PROFITEM_CURRENTUSER)
Indique à Windows de créer ou de supprimer un élément du menu Démarrer dans le profil de l’utilisateur actuel. Si cet indicateur n’est pas spécifié, Windows traite l’élément pour tous les utilisateurs.
0x00000002 (FLG_PROFITEM_DELETE)
Indique à Windows de supprimer l’élément du menu. Si cet indicateur n’est pas spécifié, l’élément est créé.
0x00000004 (FLG_PROFITEM_GROUP)
Indique à Windows de créer ou de supprimer un groupe dans le menu Démarrer sous Démarrer\Programmes. Si cet indicateur n’est pas spécifié, Windows crée ou supprime un élément de menu, pas un groupe de menus.
Si aucun indicateur n’est spécifié, Windows crée un élément de menu pour tous les utilisateurs.
CmdLine=dirid,[subdir],filename
Le dirid spécifie une valeur qui identifie le répertoire dans lequel le programme de commande se trouve. Par exemple, un dirid de 11 indique le répertoire système. Les valeurs possibles de dirid sont listées dans la description de la valeur dirid dans la section DestinationDirs.
Si une chaîne subdir est présente, le programme de commande se trouve dans un sous-répertoire du répertoire référencé par dirid. Le subdir spécifie le sous-répertoire. Si aucun subdir n’est spécifié, le programme se trouve dans le répertoire référencé par dirid.
Le filename spécifie le nom du programme associé à l’élément du menu.
SubDir=path
Cette entrée optionnelle spécifie un sous-répertoire (sous-menu) sous Démarrer\Programmes dans lequel l’élément du menu se trouve. Si cette entrée est omise, le chemin par défaut est Démarrer\Programmes.
Par exemple, si la section d’éléments de profil contient l’entrée « subdir=Accessoires\Jeux », l’élément du menu est créé ou supprimé dans le sous-menu Démarrer\Programmes\Accessoires\Jeux.
Remarque
Si FLG_PROFITEM_GROUP est spécifié pour attributs-nom, l’entrée subdir est ignorée.
WorkingDir=wd-dirid[,wd-subdir]
Cette entrée optionnelle spécifie un répertoire de travail pour le programme de commande. Si cette entrée est omise, le répertoire de travail par défaut est le répertoire dans lequel le programme de commande se trouve.
La valeur wd-dirid identifie le répertoire de travail. Pour obtenir des listes des valeurs possibles de dirid, veuillez consulter la section Utilisation des Dirids.
La chaîne wd-subdir, si elle est présente, spécifie un sous-répertoire de wd-dirid comme répertoire de travail. Utilisez ce paramètre pour spécifier un répertoire qui n’a pas de dirid défini par le système. Si ce paramètre est omis, la valeur wd-dirid seule spécifie le répertoire de travail.
IconPath=icon-dirid,[icon-subdir],icon-filename
Cette entrée optionnelle spécifie l’emplacement d’un fichier contenant une icône pour l’élément du menu.
La chaîne icon-dirid identifie le répertoire du DLL qui contient l’icône. Pour obtenir des listes des valeurs possibles de dirid, veuillez consulter la section Utilisation des Dirids.
La valeur icon-subdir, si elle est présente, indique que le DLL se trouve dans un sous-répertoire de icon-dirid. La valeur icon-subdir spécifie le sous-répertoire.
La valeur icon-filename spécifie le DLL contenant l’icône.
Si cette entrée est omise, Windows cherche une icône dans le fichier spécifié dans l’entrée CmdLine.
IconIndex=index-value
Cette entrée optionnelle spécifie quelle icône dans un DLL utiliser pour l’élément du menu. Pour plus d’informations sur la manière d’indexer les icônes dans un DLL, consultez la documentation du SDK Microsoft Windows.
Si une entrée IconPath est spécifiée, la index-value fait référence à ce DLL. Sinon, cette valeur fait référence au fichier spécifié dans l’entrée CmdLine.
HotKey=hotkey-value
Cette entrée optionnelle spécifie un accélérateur clavier pour l’élément du menu.
Pour plus d’informations sur les touches de raccourci, consultez la documentation du SDK Windows.
Infotip=info-tip
Cette entrée optionnelle spécifie une info-bulle pour l’élément du menu.
Cette valeur peut être une chaîne ou un jeton %strkey% qui est défini dans une section Strings du fichier INF.
La valeur info-tip peut également être spécifiée comme « @ResDllPath\ResDll,-ResID", ou ResDllPath et ResDll spécifient le chemin et le nom de fichier d’un DLL de ressources, et -resID est une valeur négative qui représente un ID de ressource.
Utilisez ce format pour prendre en charge l’interface utilisateur multilingue de Windows (MUI). En voici un exemple :
InfoTip = "@%11%\shell32.dll,-22531"
DisplayResource=« ResDllPath\ResDll »,ResID
Cette entrée optionnelle spécifie une chaîne de ressources qui identifie une chaîne localisable, à utiliser dans le menu Démarrer comme nom d’affichage pour le raccourci ou le groupe.
ResDllPath and ResDll spécifient le chemin et le nom de fichier d’un DLL de ressources, et resID est une valeur positive qui représente un ID de ressource. En voici un exemple :
DisplayResource="%11%\shell32.dll",22019
Utilisez cette entrée pour prendre en charge l’interface utilisateur multilingue de Windows (MUI). Si cette entrée n’est pas utilisée, la chaîne spécifiée par l’entrée Name est affichée.
Notes
Un nom donné de section profile-items doit être unique dans le fichier INF et doit suivre les règles générales pour définir les noms de section. Pour plus d'informations sur ces règles, voir Règles générales de syntaxe pour les fichiers INF.
Chaque section profile-items contient des informations détaillées pour créer ou supprimer un élément ou un groupe du menu Démarrer. Pour manipuler plusieurs éléments ou groupes de menus à partir d’un INF, créez plus d’une section profile-items et listez les sections dans la directive ProfileItems.
Tous les paramètres de chaîne spécifiés dans les entrées section profile-items peuvent être spécifiés en utilisant un jeton %strkey%, comme décrit dans les Règles générales de syntaxe pour les fichiers INF.
Exemples
L’extrait de fichier INF suivant montre comment utiliser la section profile-items pour ajouter la Calculatrice au menu Démarrer.
[CalcInstallItems]
Name = %Calc_DESC%
CmdLine = 11,, calc.exe
SubDir = %Access_GROUP%
WorkingDir = 11
InfoTip = %Calc_TIP%
:
:
[Strings]
AccessGroup = "Accessories"
Calc_DESC = "Calculator"
Calc_TIP = "Performs basic arithmetic tasks with an on-screen calculator"
L’extrait de fichier INF suivant montre comment installer le même logiciel en utilisant l’entrée DisplayResource pour créer des éléments de menu localisés.
[CalcInstallItems]
Name = %Calc_DESC%
CmdLine = 11,, calc.exe
SubDir = %Access_GROUP%
WorkingDir = 11
InfoTip = "@%11%\shell32.dll,-22531"
DisplayResource="%11%\shell32.dll",22019
:
:
[Strings]
Access_GROUP = "Accessories"
Calc_DESC = "Calculator"