Директива 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 может содержать любое количество записей имени свойства или записей guid свойства, каждая из которых находится в отдельной строке.
Операции
property-name
Одно из имен свойств, представляющих свойства пакета драйвера экземпляра устройства. Поддерживаемые имена свойств совпадают с именами, описанными для записи имени свойства директивы INF AddProperty.
property-category-guid
Значение GUID, определяющее категорию свойств. Значение GUID может быть системным ИДЕНТИФИКАТОРом GUID, определяющим системную категорию свойств или настраиваемый GUID, определяющий категорию настраиваемых свойств. Поддерживаемые значения GUID совпадают с значениями GUID, которые описаны для записи GUID категории свойств директивы INF AddProperty.
property-pid
Идентификатор свойства, указывающий конкретное свойство в категории свойств, указываемое значением property-category-guid . По внутренним системным причинам идентификатор свойства должен быть больше или равен двум.
flags
Необязательное шестнадцатеричное значение флага, которое управляет операцией удаления. Единственным поддерживаемым значением флага является следующее:
0x00000001 (FLG_DELPROPERTY_MULTI_SZ_DELSTRING)
Если тип данных свойства DEVPROP_TYPE_STRING_LIST, операция удаляет все строки с существующим списком строк, соответствующим строковой строке, предоставленной значением входа значения. Регистр символа не рассматривается в сравнении указанной строки и существующей строки в списке строк.
значение
Если тип данных свойства DEVPROP_TYPE_STRING_LIST, а запись флагов 0x00000001, значение записи значения предоставляет строку, которую операция удаления использует для поиска соответствующих строк в существующем списке строк и, если найдена соответствующая строка, операция удаления удаляет соответствующую строку из существующего списка строк.
Замечания
Как правило, INF-файл не должен использоваться для удаления свойств устройства, которые могут быть заданы системным компонентом или другим INF-файлом. Основная цель директивы DelProperty — использовать в INF-файле, который обновляет предыдущую установку устройства и свойство, заданное для предыдущей установки устройства, больше не требуется.
Имя раздела del-property-section должно быть уникальным в INF-файле, но имя раздела можно ссылаться несколькими директивами DelPropertyв том же INF-файле. Имя раздела должно соответствовать общим правилам определения имен разделов, описанных в общих правилах синтаксиса для INF-файлов.
Дополнительные сведения об использовании директивы DelProperty см. в разделе "Использование директивы INF AddProperty" и директивы INF DelProperty.
Примеры
В следующем примере раздела свойств удаления содержится две строки: первая строка содержит значение записи имени свойства, которое удаляет свойство DeviceModel , а вторая строка удаляет строку "DeleteThisString" из значения пользовательского свойства устройства, тип данных которого DEVPROP_TYPE_STRING_LIST. Во второй строке значение записи property-category-guid — "c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e" , значение записи идентификатора свойства равно "2", а значение записи флагов — "0x00000001",
[SampleDelPropertySection]
DeviceModel
{c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e}, 2, 0x00000001, "DeleteThisString"