Директива INF DelProperty

Внимание!

Если вы создаете универсальный пакет или пакет драйвера Windows, эта директива является недопустимой. См. статью Использование универсального INF-файла и начало работы с драйверами Windows.

Директива 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 можно указать в любом из разделов, показанных в описанной выше формальной инструкции синтаксиса.

Раздел del-property,на который ссылается директива DelProperty, имеет следующий формат:

[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 может содержать любое количество записей property-name или property-GUID, каждая из которых находится в отдельной строке.

Записи

property-name
Одно из имен свойств, представляющих свойства пакета драйвера экземпляра устройства. Поддерживаемые имена свойств совпадают с именами, описанными в записи property-nameдирективы INF AddProperty.

property-category-guid
Значение GUID, определяющее категорию свойств. Значением GUID может быть системный GUID, определяющий системную категорию свойств, или настраиваемый GUID, который идентифицирует настраиваемую категорию свойств. Поддерживаемые значения GUID совпадают с значениями, описанными для записи property-category-guid директивы INF AddProperty .

property-pid
Идентификатор свойства, указывающий конкретное свойство в категории свойств, обозначенное значением property-category-guid . По внутренним системным причинам идентификатор свойства должен быть больше или равен двум.

flags
Необязательное шестнадцатеричное значение флага, которое управляет операцией удаления. Поддерживается только следующее значение флага:

0x00000001 (FLG_DELPROPERTY_MULTI_SZ_DELSTRING)
Если тип данных свойства DEVPROP_TYPE_STRING_LIST, операция удаляет все строки с существующим списком строк, которые соответствуют строке, предоставленной значением ввода значения. Регистр символа не учитывается при сравнении предоставленной строки и существующей строки в списке строк.

value
Если тип данных свойства — DEVPROP_TYPE_STRING_LIST, а запись flags — 0x00000001, то входное значение предоставляет строку, которую операция удаления использует для поиска совпадающих строк в существующем списке строк, а если соответствующая строка найдена, операция удаления удаляет соответствующую строку из существующего списка строк.

Комментарии

Как правило, INF-файл не следует использовать для удаления свойств устройства, которые могут быть заданы системным компонентом или другим INF-файлом. Основная цель директивы DelProperty — использовать в INF-файле, который обновляет предыдущую установку устройства, и свойство, заданное для предыдущей установки устройства, больше не требуется.

Имя del-property-section должно быть уникальным внутри INF-файла, но на имя раздела могут ссылаться несколько директив DelPropertyв одном INF-файле. Имя раздела должно соответствовать общим правилам определения имен разделов, описанным в разделе Общие правила синтаксиса для ФАЙЛОВ INF.

Дополнительные сведения об использовании директивы DelProperty см. в разделах Использование директивы INF AddProperty и ДИРЕКТИВы INF DelProperty.

Примеры

Следующий пример раздела свойств удаления включает две записи строк: первая строка содержит значение записи property-name , которое удаляет свойство DeviceModel , а вторая строка удаляет строку "DeleteThisString" из значения настраиваемого свойства устройства, тип данных которого DEVPROP_TYPE_STRING_LIST. Во второй строке значение записи property-category-guid — "c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e", значение записи property-identifier — "2", а значение записи flags — "0x00000001",

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

См. также раздел

AddProperty