Поделиться через

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

  • Статья

В 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.