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

Sur les systèmes d’exploitation Windows XP et 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 qualificatifs de propriété déterminent la page de propriété

Le fournisseur de pages de propriétés générique WMI utilise un contrôle approprié pour le type de données de chaque propriété de la classe. Les qualificateurs de propriété 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érique valide que les données entrées sont conformes à la plage spécifiée.

• NomD'Affichage

  Le fournisseur de pages de propriétés générique 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 les classes à utiliser par Wmiprop.dll doit activer Wmiprop.dll en tant que co-programme d’installation. Pour ce faire, effectuez l'ajout suivant à la section "add-registry" du co-installateur : 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. Consultez Inscription d’un co-installateur de classe pour plus d’informations.

Vous devez également spécifier les classes WMI particulières à exposer via le fournisseur de propriétés générique. Pour ce faire, définissez l’entrée de 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 de l’instance matérielle d’appareil.

; 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 la directive AddReg INF pour obtenir une description d’une section add-registry dans les fichiers INF.

Wmiprop.dll part du principe qu'une seule instance de chaque classe existe. Chaque classe est représentée par un onglet de la feuille de propriétés. Utilisez le qualificateur de propriété DisplayName pour définir le texte du 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 non démarré, les pages n’apparaissent pas.