Directive INF DelProperty

Attention

Si vous créez un package de pilote universel ou Windows, cette directive n’est pas valide. Consultez Utilisation d’un fichier INF universel et Prise en main avec des pilotes Windows.

Une directive DelProperty fait référence à une ou plusieurs sections de fichier INF qui suppriment les propriétés d’un appareil instance, d’une classe d’installation d’appareil, d’une classe d’interface d’appareil ou d’une interface d’appareil.

[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)
[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] 
 
DelProperty=del-property-section[,del-property-section]... (Windows Vista and later versions of Windows)

Une directive DelProperty peut être spécifiée sous l’une des sections indiquées dans l’instruction de syntaxe formelle ci-dessus.

Une del-property-section référencée par une directive DelProperty a le format suivant :

[del-property-section]
(property-name [ ,, flags [, value]]) | ({property-category-guid}, property-pid [ , flags [, value]])
(property-name [ ,, flags [, value]]) | ({property-category-guid}, property-pid [ , flags [, value]])
...

Une del-property-section peut avoir un nombre quelconque 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é qui représentent les propriétés du périphérique instance package de pilotes. Les noms de propriétés pris en charge sont les mêmes que ceux décrits pour l’entrée property-name de la directive INF AddProperty.

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 une catégorie de propriété définie par le système ou un GUID personnalisé qui identifie une catégorie de propriété personnalisée. Les valeurs GUID prises en charge sont les mêmes que celles décrites pour l’entrée property-category-guid de la directive INF AddProperty .

property-pid
Identificateur de propriété qui indique la propriété spécifique dans la catégorie de propriété 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.

flags
Valeur d’indicateur hexadécimal facultative qui contrôle l’opération de suppression. La seule valeur d’indicateur prise en charge est la suivante :

0x00000001 (FLG_DELPROPERTY_MULTI_SZ_DELSTRING)
Si le type de données de la propriété est DEVPROP_TYPE_STRING_LIST, l’opération supprime toutes les chaînes avec la liste de chaînes existante qui correspondent à la chaîne fournie par la valeur d’entrée de valeur. La casse d’un caractère n’est pas prise en compte dans la comparaison entre la chaîne fournie et une chaîne existante dans la liste de chaînes.

value
Si le type de données de propriété est DEVPROP_TYPE_STRING_LIST et que l’entrée d’indicateurs est 0x00000001, la valeur d’entrée de valeur fournit la chaîne que l’opération de suppression utilise pour rechercher des chaînes correspondantes dans la liste de chaînes existante et, si une chaîne correspondante est trouvée, l’opération de suppression supprime la chaîne correspondante de la liste de chaînes existante.

Remarques

En général, un fichier INF ne doit pas être utilisé pour supprimer des propriétés d’appareil qui peuvent être définies par un composant système ou par un autre fichier INF. L’objectif principal de la directive DelProperty est d’être utilisé dans un fichier INF qui met à jour une installation d’appareil précédente et une propriété qui a été définie pour une installation d’appareil précédente n’est plus nécessaire.

Un nom del-property-section doit être unique dans un fichier INF, mais le nom de section peut être référencé par plusieurs directives DelPropertydans le même fichier INF. Un 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 DelProperty , consultez Utilisation de la directive INF AddProperty et de la directive INF DelProperty.

Exemples

L’exemple suivant d’une section de propriété delete comprend deux entrées de ligne : la première entrée de ligne inclut une valeur d’entrée nom-propriété qui supprime la propriété DeviceModel , et la deuxième entrée de ligne supprime la chaîne « DeleteThisString » d’une valeur de propriété d’appareil personnalisée dont le type de données est DEVPROP_TYPE_STRING_LIST. Dans la deuxième ligne, la valeur d’entrée property-category-guid est « c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e », la valeur d’entrée de l’identificateur de propriété est « 2 » et la valeur d’entrée des indicateurs est « 0x00000001 , ».

[SampleDelPropertySection]
DeviceModel
{c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e}, 2, 0x00000001, "DeleteThisString"

Voir aussi

AddProperty