Создание настраиваемых свойств устройства

В Windows Vista и более поздних версиях Windows модель унифицированных свойств устройства поддерживает создание пользовательских категорий свойств устройств для экземпляров устройств, классов установки устройств, классов интерфейса устройства и интерфейсов устройств. Доступ к пользовательскому свойству можно получить путем вызова соответствующей функции свойства. Пользовательское свойство устройства также можно изменить из пакета драйвера с помощью директивы INF AddProperty или директивы INF DelProperty.

Дополнительные сведения о свойствах пользовательских устройств см. в следующих разделах:

Создание категорий настраиваемых свойств устройства

Использование функций свойств для доступа к пользовательским свойствам устройства

Использование директивы INF AddProperty или директивы INF DelProperty для изменения пользовательского свойства устройства

Создание категорий настраиваемых свойств устройства

Категория свойств пользовательского устройства — это логическая коллекция настраиваемых свойств устройства. Чтобы программно создать пользовательскую категорию свойств устройства, используйте макрос DEFINE_DEVPROPKEY для создания ключей свойств, представляющих свойства в категории свойств, как показано ниже.

• Создайте уникальное значение GUID, представляющее категорию свойств, и задайте значение GUID каждого ключа свойства для этого уникального значения GUID. Сведения о создании нового значения GUID см. в разделе "Определение и экспорт новых идентификаторов GUID".

  Примечание.

  Системные категории свойств зарезервированы только для использования операционной системы.

• Задайте идентификатор свойства каждого ключа свойства целочисленным значением, уникальным в категории свойств и превышающим или равным двум.

Можно также создать пользовательскую категорию свойств устройства для экземпляра устройства с помощью директивы INF AddProperty.

Использование функций свойств для доступа к пользовательским свойствам устройства

Доступ к настраиваемым свойствам устройства таким же образом, как описано в разделе "Свойства доступа").

Использование директивы INF AddProperty или директивы INF DelProperty для изменения пользовательского свойства устройства

Чтобы изменить настраиваемое свойство устройства с помощью директивы INF AddProperty, включите директиву AddProperty в раздел, который устанавливает компонент и предоставляет следующие записи для свойства:

• Запись property-category-guid, представляющая категорию настраиваемых свойств устройства

• Запись идентификатора свойства, идентифицирующая свойство в категории пользовательских свойств устройства

• Запись значения нового свойства устройства или запись значения , изменяющая существующее значение свойства устройства.

Используйте директиву INF DelProperty для удаления пользовательского свойства устройства.

Дополнительные сведения об использовании этих директив см. в директиве INF AddProperty и директиве INF DelProperty.