Directive INF ProfileItems

Attention

À compter de Windows 11 version 22H2, un package de pilotes utilisant cette directive n’est plus éligible à 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 ProfileItems est utilisée dans une section INF DDInstall pour répertorier une ou plusieurs sections d’éléments de profil qui contiennent des éléments ou des groupes à ajouter ou à supprimer dans le 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.

Entrées

Name=link-name[,name-attributes]
Le nom du lien spécifie le nom du lien pour l’élément de menu ou le groupe, sans l’extension .lnk . Cette valeur peut être une chaîne ou un jeton %strkey% défini dans une section Strings du fichier INF. Si une entrée DisplayResource n’est pas spécifiée, link-name est également la chaîne d’affichage.

La valeur nom-attributs facultative spécifie un ou plusieurs indicateurs qui affectent l’opération sur l’élément de menu. Cette valeur est exprimée sous la forme d’un masque de bits ORed de valeurs d’indicateur définies par le système. Les indicateurs possibles sont les suivants :

0x00000001 (FLG_PROFITEM_CURRENTUSER)
Indique à Windows de créer ou de supprimer un élément de 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 de 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 de menus Démarrer sous Démarrer\Programmes. Si cet indicateur n’est pas spécifié, Windows crée ou supprime un élément de menu, et non 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 réside le programme de commandes. Par exemple, un dirid de 11 indique le répertoire système. Les valeurs dirid possibles sont répertorié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 sous-répertoire spécifie le sous-répertoire. Si aucun sous-dir n’est spécifié, le programme se trouve dans le répertoire référencé par dirid.

Le nom de fichier spécifie le nom du programme associé à l’élément de menu.

SubDir=path
Cette entrée facultative spécifie un sous-répertoire (sous-menu) sous Démarrer\Programmes dans lequel réside l’élément de menu. Si cette entrée est omise, le chemin par défaut est Start\Programs.

Par exemple, si la section profile-items-section a l’entrée « Subdir=Accessories\Games », l’élément de menu est en cours de création ou de suppression dans le sous-menu Démarrer\Programs\Accessories\Games.

Notes

Si FLG_PROFITEM_GROUP est spécifié pour les name-attributes, l’entrée SubDir est ignorée.

WorkingDir=wd-dirid[,wd-subdir]
Cette entrée facultative spécifie un répertoire de travail pour le programme de commandes. Si cette entrée est omise, le répertoire de travail est défini par défaut sur le répertoire dans lequel réside le programme de commandes.

La valeur wd-dirid identifie le répertoire de travail. Pour obtenir la liste des valeurs dirid possibles, consultez Utilisation de 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 facultative spécifie l’emplacement d’un fichier qui contient une icône pour l’élément de menu.

La chaîne d’icône-dirid identifie le répertoire de la DLL qui contient l’icône. Pour obtenir la liste des valeurs dirid possibles, consultez Utilisation de Dirids.

La valeur icon-subdir , si elle est présente, indique que la DLL se trouve dans un sous-répertoire d’icon-dirid. La valeur icon-subdir spécifie le sous-répertoire.

La valeur icon-filename spécifie la DLL qui contient l’icône.

Si cette entrée est omise, Windows recherche une icône dans le fichier spécifié dans l’entrée CmdLine .

IconIndex=index-value
Cette entrée facultative spécifie l’icône d’une DLL à utiliser pour l’élément de menu. Pour plus d’informations sur l’indexation des icônes dans une DLL, consultez la documentation Microsoft Windows SDK.

Si une entrée IconPath est spécifiée, l’index-valeur est indexé dans cette DLL. Sinon, cette valeur s’indexe dans le fichier spécifié dans l’entrée CmdLine .

HotKey=hotkey-value
Cette entrée facultative spécifie un accélérateur de clavier pour l’élément de menu.

Pour plus d’informations sur les clés d’accès rapide, consultez la documentation du Kit de développement logiciel (SDK) Windows.

Infotip=info-tip
Cette entrée facultative spécifie un conseil d’information pour l’élément de menu.

Cette valeur peut être une chaîne ou un jeton %strkey% défini dans une section Strings du fichier INF.

La valeur info-tip peut également être spécifiée comme « @ResDllPath\ResDll,-ResID», où ResDllPath et ResDll spécifient le chemin d’accès et le nom de fichier d’une DLL de ressource, 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 (MUI) Windows. En voici un exemple :

InfoTip = "@%11%\shell32.dll,-22531"

DisplayResource="ResDllPath\ResDll »,ResID
Cette entrée facultative spécifie une ressource de chaîne qui identifie une chaîne localisable, à utiliser dans le menu Démarrer comme nom d’affichage pour le raccourci ou le groupe.

ResDllPath et ResDll spécifient le chemin d’accès et le nom de fichier d’une DLL de ressource, 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 (MUI) Windows. Si cette entrée n’est pas utilisée, la chaîne spécifiée par l’entrée Nom s’affiche.

Remarques

Un nom de section de profil donné 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.

Chaque section éléments de profil contient des informations détaillées sur la création ou la suppression d’un élément ou d’un groupe de menu Démarrer. Pour manipuler plusieurs éléments de menu ou groupes à partir d’un inf, créez plusieurs sections d’éléments de profil et répertoriez les sections de la directive ProfileItems .

Tous les paramètres de chaîne spécifiés dans les entrées profile-items-section peuvent être spécifiés à l’aide d’un jeton %strkey%, comme décrit dans Règles de syntaxe générales pour les fichiers INF.

Exemples

L’extrait de fichier INF suivant montre comment utiliser la section éléments de profil 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 à l’aide de 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"

Voir aussi

DDInstall