Directive INF DelProperty
Attention
Si vous créez un package de pilote universel ou Windows, cette directive n’est pas valide. Veuillez consulter la section Utilisation d’un fichier INF universel et Premiers pas dans le développement de pilotes Windows.
Une directive DelProperty fait référence à une ou plusieurs sections de fichiers INF qui suppriment des propriétés de périphérique pour une instance de périphérique, une classe d’installation de périphérique, une classe d’interface de périphérique ou une interface de périphérique.
[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 dans n’importe laquelle des sections indiquées dans l’énoncé 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 comporter un nombre quelconque d’entrées property-name ou d’entrées property-guid, chacune sur une ligne distincte.
Entries
property-name
L’un des noms de propriété représente les propriétés du package du pilote de l’instance de périphérique. 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 directive.
property-category-guid
Une 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 guid-catégorie-de-propriété de la directive INF AddProperty.
property-pid
Un identificateur de propriété qui indique la propriété spécifique au sein de la catégorie de propriété indiquée par la valeur guid-catégorie-de-propriété. Pour des raisons internes au système, un identificateur de propriété doit être supérieur ou égal à deux.
flags
Une valeur d’indicateur hexadécimale 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 de la liste de chaînes existante qui correspondent à la chaîne fournie par la valeur d’entrée. 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.
valeur
Si le type de données de la propriété est DEVPROP_TYPE_STRING_LIST et que l’entrée des indicateurs est 0x00000001, la valeur d’entrée value fournit la chaîne que l’opération de suppression utilise pour rechercher les 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.
Notes
En général, un fichier INF ne doit pas être utilisé pour supprimer des propriétés de périphérique qui pourraient ê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ée dans un fichier INF qui met à jour une installation de périphérique précédente et où une propriété définie pour une installation de périphérique précédente n’est plus nécessaire.
Un nom de del-property-section doit être unique au sein d’un fichier INF, mais le nom de la section peut être référencé par plus d’une directive DelProperty dans 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 la section Utilisation de la directive INF AddProperty et de la directive INF DelProperty.
Exemples
L’exemple suivant d’une section de suppression de propriété comprend deux entrées de ligne : la première entrée de ligne comprend une valeur d’entrée property-name 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é de périphérique 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 property-identifier est « 2 », et la valeur d’entrée flags est « 0x00000001 »
[SampleDelPropertySection]
DeviceModel
{c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e}, 2, 0x00000001, "DeleteThisString"