Directive Inf AddProperty
Une directive AddProperty fait référence à une ou plusieurs sections de fichier INF qui modifient les propriétés d’appareil définies pour un instance d’appareil, une classe de configuration d’appareil, une classe d’interface d’appareil ou une interface d’appareil.
[DDInstall] |
[DDInstall.nt] |
[DDInstall.ntx86] |
[DDInstall.ntia64] |
[DDInstall.ntamd64] |
[DDInstall.ntarm] |
[DDInstall.ntarm64]
[ClassInstall32] |
[ClassInstall32.nt] |
[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)
[interface-install-section] |
[interface-install-section.nt] |
[interface-install-section.ntx86] |
[interface-install-section.ntia64] | (Windows XP and later versions of Windows)
[interface-install-section.ntamd64] | (Windows XP and later versions of Windows) |
[interface-install-section.ntarm] | (Windows 8 and later versions of Windows) |
[interface-install-section.ntarm64] | (Windows 10 version 1709 and later versions of Windows)
[add-interface-section]
AddProperty=add-property-section[,add-property-section]... (Windows Vista and later versions of Windows)
...
Chaque add-property-section peut avoir des entrées pour effectuer les opérations suivantes :
Ajoutez une propriété d’appareil et initialisez la valeur de la propriété .
Modifiez la valeur d’une propriété d’appareil existante.
Une add-property-section référencée par une directive AddProperty a le format suivant :
[add-property-section]
(property-name, , , [flags], value]) |
({property-category-guid}, property-pid, type, [flags], value)
...
Une section Ajouter une propriété peut avoir n’importe quel nombre d’entrées de nom de propriété ou d’entrées guid de propriété , chacune sur une ligne distincte.
Entrées
property-name
L’un des noms de propriétés suivants qui représentent les propriétés du package de pilote d’appareil instance :
DeviceModel
DeviceVendorWebsite
DeviceDetailedDescription
DeviceDocumentationLink
DeviceIcon
DeviceBrandingIcon
Pour plus d’informations sur l’ajout d’icônes d’appareil personnalisées, consultez Fournir des icônes pour un appareil.
property-category-guid
Valeur GUID qui identifie la catégorie de propriété. La valeur GUID peut être un GUID défini par le système qui identifie l’une des catégories de propriétés d’un instance d’appareil, d’une classe d’installation d’appareil, d’une classe d’interface d’appareil ou d’une interface d’appareil. Toutes les propriétés qui ont la même valeur GUID sont membres de la même catégorie. Ces catégories de propriétés sont définies dans Devpkey.h.
La valeur GUID peut également être une valeur GUID personnalisée qui identifie une catégorie de propriété personnalisée.
property-pid
Identificateur de propriété qui indique la propriété spécifique dans la catégorie de propriété qui est indiquée par la valeur property-category-guid . Pour des raisons système internes, un identificateur de propriété doit être supérieur ou égal à deux.
type
Valeur numérique, au format décimal ou hexadécimal, de l’identificateur de type property-data-type pour la propriété spécifiée par la valeur property-category-guid et la valeur property-pid . Seuls les types de données de base suivants sont pris en charge :
DEVPROP_TYPE_STRING
DEVPROP_TYPE_STRING_LIST
DEVPROP_TYPE_BINARY
DEVPROP_TYPE_BOOLEAN
DEVPROP_TYPE_UINT32
Par exemple, la valeur décimale du type de données DEVPROP_TYPE_STRING est 18 (0x00000012) et la valeur décimale du type de données DEVPROP_TYPE_STRING_LIST est 8210 (0x00002012).
flags
Valeur hexadécimale facultative qui est un OR au niveau du bit des indicateurs suivants qui contrôlent l’opération d’ajout :
0x00000001 (FLG_ADDPROPERTY_NOCLOBBER)
Indicateur qui empêche la valeur d’entrée de valeur de remplacer la valeur de propriété existante. Si un enregistreur de pilotes souhaite qu’une propriété puisse être remplacée par le biais des directives Include et Needs , l’enregistreur doit spécifier cet indicateur pour cette propriété. En effet, Windows traite les sections INF référencées par les directives Include et Needs après que Windows a traité toutes les autres directives de la section INF qui comprenait les directives Include et Needs .
0x00000002 (FLG_ADDPROPERTY_OVERWRITEONLY)
Indicateur qui définit la valeur de la propriété sur la valeur d’entrée de valeur uniquement si la propriété spécifiée existe déjà.
0x00000004 (FLG_ADDPROPERTY_APPEND)
Indicateur qui ajoute la valeur d’entrée de valeur à celle d’une valeur de chaîne de propriété existante. Cet indicateur est valide uniquement si le type de données de propriété est DEVPROP_TYPE_STRING_LIST. La chaîne fournie n’est pas ajoutée à une valeur de chaîne de propriété existante si la chaîne fournie est déjà présente dans la valeur de chaîne existante.
0x00000008 (FLG_ADDPROPERTY_OR)
Indicateur qui effectue une OR au niveau du bit de la valeur d’entrée à celle de la valeur de la propriété existante. Cet indicateur est valide uniquement si le type de données de propriété est DEVPROP_TYPE_UINT32.
0x00000010 (FLG_ADDPROPERTY_AND)
Indicateur qui effectue une valeur AND au niveau du bit de la valeur d’entrée à celle de la valeur de la propriété existante. Cet indicateur est valide uniquement si le type de données de propriété est DEVPROP_TYPE_UINT32.
value
Valeur que l’opération d’ajout utilise pour modifier une valeur de propriété, en fonction du type de données de propriété et de la valeur de l’entrée d’indicateurs .
Remarques
La directive AddProperty peut être utilisée pour modifier une propriété d’appareil définie par le système ou une propriété d’appareil personnalisée. Cette directive peut être spécifiée sous l’une des sections indiquées dans l’instruction de syntaxe formelle ci-dessus.
Chaque nom de section de propriété de complément doit être unique dans un fichier INF, mais la section peut être référencée par plusieurs directives AddProperty dans le même fichier INF. Chaque nom de section doit suivre les règles générales de définition des noms de section décrites dans Règles de syntaxe générales pour les fichiers INF.
Pour plus d’informations sur l’utilisation de la directive AddProperty INF, consultez Utilisation de la directive AddProperty INF et de la directive INF DelProperty.
Exemples
L’exemple suivant d’une section ajouter une propriété inclut deux entrées de ligne : la première entrée définit la propriété DeviceModel par nom et l’entrée de deuxième ligne définit une propriété d’appareil personnalisée en spécifiant un GUID de clé de propriété personnalisée.
La première ligne comprend la valeur d’entrée de nom de propriété « DeviceModel » et la valeur d’entrée « Sample Device Model Name ».
L’entrée de deuxième ligne définit une propriété personnalisée dans une catégorie de propriété personnalisée. La valeur d’entrée property-category-guid est « c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e » et la valeur d’entrée de l’identificateur de propriété est « 2 ».
La valeur d’entrée des indicateurs facultatifs n’est pas présente et la valeur d’entrée de type est « 18 » (DEVPROP_TYPE_STRING). La valeur d’entrée de valeur est « Valeur de chaîne pour la propriété 1 ».
[SampleAddPropertySection]
DeviceModel,,,,"Sample Device Model Name"
{c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e}, 2, 18,, "String value for property 1"