INF DelProperty 指令

  • 项目

注意

如果要生成通用或 Windows 驱动程序包，则此指令无效。 请参阅在 Windows 驱动程序中使用通用 INF 文件和入门。

DelProperty 指令引用一个或多个 INF 文件部分，用于删除设备实例、设备设置类、设备接口类或设备接口的设备属性。

[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)

可以在上述正式语法语句所示的任何部分下指定 DelProperty 指令。

DelProperty 指令引用的 del-property-section 具有以下格式：

[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]])
...

del-property-section 可以有任意数量的属性名称条目或属性 guid 条目，每个条目位于单独的行上。

项

property-name
表示设备实例 驱动程序包 属性的属性名称之一。 支持的属性名称与为 INF AddProperty 指令的属性名称条目描述的属性名称相同。

property-category-guid
标识属性类别的 GUID 值。 GUID 值可以是标识系统定义的属性类别的系统定义的 GUID，也可以是标识自定义属性类别的自定义 GUID。 支持的 GUID 值与为 INF AddProperty 指令的 property-category-guid 条目描述的值相同。

property-pid
一个属性标识符，指示属性类别中由 property-category-guid 值指示的特定属性。 出于内部系统原因，属性标识符必须大于或等于 2。

flag
一个可选的十六进制标志值，用于控制删除操作。 唯一支持的标志值如下所示：

0x00000001 (FLG_DELPROPERTY_MULTI_SZ_DELSTRING)
如果属性数据类型 为DEVPROP_TYPE_STRING_LIST，则操作将删除与值输入值提供的字符串匹配的现有字符串列表的所有字符串。 在提供的字符串与字符串列表中的现有字符串之间的比较中，不考虑字符大小写。

value
如果属性数据类型为DEVPROP_TYPE_STRING_LIST并且标志项 0x00000001， 则值 输入值将提供删除操作用于在现有字符串列表中搜索匹配字符串的字符串，如果找到匹配的字符串，则删除操作将从现有字符串列表中删除匹配的字符串。

注解

通常，INF 文件不应用于删除可能由系统组件或其他 INF 文件设置的设备属性。 DelProperty 指令的主要用途是在更新以前的设备安装的 INF 文件中使用，不再需要为以前的设备安装设置的属性。

del-property-section 名称在 INF 文件中必须是唯一的，但节名称可由同一 INF 文件中的多个 DelProperty指令引用。 节名称必须遵循用于定义 INF 文件的一般语法规则中所述的节名称的一般规则。

有关如何使用 DelProperty 指令的详细信息，请参阅 使用 INF AddProperty 指令和 INF DelProperty 指令。

示例

删除属性节的以下示例包含两个行条目：第一个行条目包含删除 DeviceModel 属性的属性名称条目值，第二行条目从数据类型为DEVPROP_TYPE_STRING_LIST的自定义设备属性值中删除字符串“DeleteThisString”。 第二行中， property-category-guid 条目值为“c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e”， 属性标识符 条目值为“2”， 标志 条目值为“0x00000001”

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

另请参阅

AddProperty