Partager via

Fournisseur de pages de propriétés génériques WMI

  • Article

Sur Windows XP et les systèmes d’exploitation ultérieurs, les pilotes peuvent exposer leurs classes WMI via le fournisseur de pages de propriétés génériques WMI. Le fournisseur utilise chaque déclaration de classe pour créer une page de propriétés simple pour les propriétés de classe.

Comment les qualificateurs de propriétés déterminent la page de propriétés

Le fournisseur de pages de propriétés génériques WMI utilise un contrôle approprié pour le type de données de chaque propriété de la classe. Les qualificateurs de propriétés suivants modifient le type de contrôle utilisé :

  • Écrire

    Une propriété avec le qualificateur d’écriture peut être modifiée via la page de propriétés. Sinon, la propriété est en lecture seule.

  • Valeurs et ValuesMap

    Le fournisseur de pages de propriétés génériques utilise une zone de liste pour représenter les valeurs possibles.

  • Plage

    Le fournisseur de pages de propriétés génériques vérifie que les données entrées sont conformes à la plage spécifiée.

  • DisplayName

    Le fournisseur de pages de propriétés génériques utilise la valeur de ce qualificateur de propriété comme étiquette pour la propriété.

  • DisplayInHex

    Si elle est présente, la valeur de la propriété est affichée en hexadécimal.

Les enregistreurs de pilotes doivent localiser les qualificateurs de propriété qui sont des chaînes. Pour plus d’informations, consultez Localisation des fichiers MOF .

Activation du fournisseur de pages de propriétés génériques

Chaque appareil qui expose des classes à utiliser par Wmiprop.dll doit activer Wmiprop.dll en tant que co-programme d’installation. Pour ce faire, ajoutez l’ajout suivant à la section add-registry du co-programme d’installation : ajoutez une entrée de valeur pour le GUID de classe sous la clé de Registre HKLM\System\CurrentControlSet\Control\CoDeviceInstallers . La valeur de l’entrée de valeur est « WmiProp.dll, WmiPropCoInstaller ».

Par exemple :

; 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 est le GUID de la classe WMI. Pour plus d’informations, consultez Inscription d’un co-programme d’installation de classe.

Vous devez également spécifier les classes WMI particulières à exposer via le fournisseur de propriétés génériques. Pour ce faire, définissez l’entrée valeur WmiConfigClasses sur une liste séparée par des virgules des classes WMI dans la section add-registry de la classe d’appareil ou du matériel d’appareil instance.

; 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"

Consultez Directive AddReg INF pour obtenir une description d’une section de registre supplémentaire dans les fichiers INF.

Wmiprop.dll suppose qu’une seule instance de chaque classe. Chaque classe est représentée par un onglet sur la feuille de propriétés. Utilisez le qualificateur de propriété DisplayName pour définir le texte de titre de l’onglet. Une page de propriétés pour une classe s’affiche uniquement s’il existe actuellement une instance de la classe. Par conséquent, si l’appareil est supprimé ou n’est pas démarré, les pages n’apparaissent pas.