Поставщик универсальной страницы свойств WMI

В Windows XP и более поздних операционных системах драйверы могут предоставлять свои классы WMI через универсального поставщика страниц свойств WMI. Поставщик использует каждое объявление класса для создания простой страницы свойств для свойств класса.

Как квалификаторы свойств определяют страницу свойств

Поставщик универсальной страницы свойств WMI использует элемент управления, соответствующий типу данных каждого свойства в классе. Следующие квалификаторы свойств изменяют тип используемого элемента управления:

• Написать

  Свойство с квалификатором write можно изменить через страницу свойств. В противном случае свойство доступно только для чтения.

• Значения и карта значений

  Поставщик страницы универсального свойства использует поле списка для представления возможных значений.

• Диапазон

  Поставщик страницы универсального свойства проверяет, соответствуют ли введенные данные указанному диапазону.

• ИмяДисплея

  Поставщик страницы универсального свойства использует значение квалификатора этого свойства в качестве метки для свойства.

• DisplayInHex

  При наличии значение свойства отображается в шестнадцатеричном формате.

Разработчики драйверов должны локализовать квалификаторы свойств, которые являются строками. Дополнительные сведения см. в разделе "Локализация MOF-файлов ".

Включение провайдера страницы общих свойств

Каждое устройство, которое предоставляет классы для использования Wmiprop.dll, должно включить Wmiprop.dll в качестве совместного установщика. Для этого добавьте следующее в раздел добавить-раздел-реестра надстройки установщика: добавьте запись для GUID класса в разделе реестра HKLM\System\CurrentControlSet\Control\CoDeviceInstallers. Значением для входного значения является "WmiProp.dll, WmiPropCoInstaller".

Рассмотрим пример.

; This section is defined in the Co-installer section, as follows.
; [Co-installer]
; AddReg = CoInstaller_AddReg

[CoInstaller_AddReg] 
HKLM, System\CurrentControlSet\Control\CoDeviceInstallers, ClassGUID,
    0x00010000, "WmiProp.dll, WmiPropCoInstaller"

ClassGUID — это GUID для класса WMI. Дополнительные сведения см. в разделе "Регистрация совместного установщика класса ".

Необходимо также указать конкретные классы WMI, которые будут доступны через универсальный поставщик свойств. Для этого задайте параметру WmiConfigClasses значение в виде списка классов WMI, разделенного запятыми, в разделе добавления в реестр класса устройства или экземпляра аппаратного обеспечения устройства.

; the device class AddReg section.
[device_class_AddReg]
HKR,,"WmiConfigClasses",0x00000000,"class1,class2"

; the device hardware instance AddReg section.
[device_hw_inst_AddReg]
HKR,,"WmiConfigClasses",0x00000000,"class3"

См. директиву INF AddReg для описания раздела добавления в реестр в INF-файлах.

Wmiprop.dll предполагает только один экземпляр каждого класса. Каждый класс представлен вкладкой на листе свойств. Используйте квалификатор свойства DisplayName , чтобы задать текст заголовка вкладки. Страница свойств для класса отображается только в том случае, если в настоящее время существует экземпляр класса. Таким образом, если устройство удалено или не запущено, страницы не отображаются.