DEVPKEY_DrvPkg_Icon
La propriété d’appareil DEVPKEY_DrvPkg_Icon représente une liste d’icônes d’appareil que Windows utilise pour représenter visuellement un appareil instance.
| Attribut | Valeur |
|---|---|
| Clé de propriété | DEVPKEY_DrvPkg_Icon |
| Identificateur de type de données de propriété | DEVPROP_TYPE_STRING_LIST |
| Accès à la propriété | Accès en lecture seule par les applications d’installation et les programmes d’installation |
| Localisée | Yes |
Notes
Chaque icône de la liste est spécifiée par un chemin d’accès d’un fichier d’icône (*.ico) ou une référence à une ressource d’icône dans un fichier exécutable.
La première icône de la liste est utilisée comme valeur par défaut. Des icônes supplémentaires peuvent être fournies qui fournissent différentes représentations visuelles d’un appareil. Windows inclut une interface utilisateur qui permet à un utilisateur de sélectionner l’icône que Windows affiche. Par exemple, Microsoft DiscoveryCam 530 est disponible en bleu, vert et rouge. Microsoft fournit une icône pour chaque couleur. Windows utilise l’icône bleue par défaut, car il s’agit de la première de la liste. Toutefois, les utilisateurs de Windows peuvent également choisir l’icône verte ou l’icône rouge.
La liste d’icônes est une liste de spécificateurs d’icônes séparées par NULL. Un spécificateur d’icône est un chemin d’accès d’un fichier d’icône (*.ico) ou un spécificateur de ressource d’icône, comme suit :
Le format du chemin d’accès à un fichier d’icône est DirectoryPath\filename.ico.
Un spécificateur icon-resource contient les entrées suivantes :
@executable-file-path,resource-identifierLe premier caractère du spécificateur icon-resource est le signe at (@) suivi du chemin d’accès d’un fichier exécutable (un fichier *.exe ou *.dll ), suivi d’un séparateur de virgules (,), puis de l’entrée d’identificateur de ressource .
Par exemple, le spécificateur d’icône « @shell32.dll,-30 » représente le fichier exécutable « shell32.dll » et l’identificateur de ressource « -30 ».
Un identificateur de ressource doit être une valeur entière, qui correspond à une ressource dans le fichier exécutable, comme suit :
Si l’identificateur fourni est négatif, Windows utilise la ressource dans le fichier exécutable dont l’identificateur est égal à la valeur absolue de l’identificateur fourni.
Si l’identificateur fourni est égal à zéro, Windows utilise la ressource dans le fichier exécutable dont l’identificateur a la valeur la plus faible dans le fichier exécutable.
Si l’identificateur fourni est positif, par exemple, la valeur n, Windows utilise la ressource dans le fichier exécutable dont l’identificateur est la valeur n+1 la plus faible dans le fichier exécutable. Par exemple, si la valeur de n est 1, Windows utilise la ressource dont l’identificateur a la deuxième valeur la plus faible dans le fichier exécutable.
Vous pouvez définir la valeur de DEVPKEY_DrvPkg_Icon par une directive INF AddProperty incluse dans la section INF DDInstall du fichier INF qui installe l’appareil. Vous pouvez récupérer la valeur de DEVPKEY_DrvPkg_Icon en appelant CM_Get_DevNode_Property ou SetupDiGetDeviceProperty.
Voici un exemple d’utilisation d’une directive INF AddProperty pour définir DEVPKEY_DrvPkg_Icon pour un appareil installé par une section INF DDInstall « SampleDDInstallSection » :
[SampleDDinstallSection]
...
AddProperty=SampleAddPropertySection
...
[SampleAddPropertySection]
DeviceIcon,,,,"SomeResource.dll,-2","SomeIcon.icon"
...
Spécifications
Version : Windows Vista et versions ultérieures de Windows
En-tête : Devpkey.h (inclure Devpkey.h)