Partager via

Prise en charge de la classe Win32_PerfRawData

  • Article

Lors de l’écriture d’un fournisseur hautes performances qui dérive des classes de Win32\_PerfRawData, vous devez suivre des conventions spécifiques afin que WMI puisse fournir des données aux valeurs de propriété.

Notes

L’écriture d’un fournisseur de haute performance WMI pour créer des compteurs de performances n’est recommandée sur aucune version du système d’exploitation Windows. Pour plus d’informations, consultez Faire d’un fournisseur d’instances un fournisseur de hautes performances et Bibliothèques de performances et WMI.

 

La procédure suivante décrit comment prendre en charge la classe Win32_PerfRawData avec votre fournisseur de hautes performances.

Prise en charge de la classe Win32_PerfRawData

  1. Créez votre classe dans l’espace de noms Root\CIMv2.

    La classe doit être dérivée de Win32_PerfRawData et avoir le qualificateur Hiperf défini sur TRUE. Vous pouvez également ajouter des classes de données de performances WDM (pilote) à l’espace de noms root\wmi. Pour plus d’informations sur la création de votre propre classe pour WMI, consultez Conception des classes format MOF (Managed Object Format).

  2. Spécifiez le fournisseur comme « NT5_GenericPerfProvider_V1 » dans le qualificateur Provider.

  3. Spécifiez les qualificateurs de niveau classe suivants :

    • HiPerf
    • Paramètres régionaux
    • PerfDetail
    • Fournisseur

    Pour plus d’informations, consultez Qualificateurs de classes pour les classes de compteur de performances. Ne définissez pas le qualificateur GenericPerfCtr, car il est réservé au processus ADAP qui transfère les données de la bibliothèque de performances dans des classes WMI.

  4. Renseignez les propriétés d’horodatage et de fréquence appropriées utilisées pour calculer des formules de contretype.

    Ces propriétés sont héritées de Win32_PerfRawData et, si vous écrivez un fournisseur de hautes performances, vous devez les remplir pour que la classe s’affiche dans le moniteur système.

  5. Incluez une propriété de clé appelée Name dans votre classe (cette propriété n’est pas obligatoire pour les classes singleton).

    Vous ne devez utiliser aucune propriété de clé autre que Name dans votre classe.

  6. Créez des propriétés de type données en tant que DWORD (uint32) ou QWORD (uint64). Ces propriétés deviennent des compteurs de performances lorsqu’elles sont transférées vers les bibliothèques de performances.

  7. Spécifiez les qualificateurs de niveau de propriété suivants pour toutes les propriétés de votre classe :

    • DisplayName
    • CounterType
    • DefaultScale
    • Description
    • PerfDefault
    • PerfDetail

    Pour plus d’informations, consultez Qualificateurs de classes pour les classes de compteur de performances. En outre, le fichier d’en-tête Winperf.h contient des valeurs que vous pouvez spécifier pour PerfDetail et CounterType.

    WMI utilise les qualificateurs DisplayName, Locale et Description pour la localisation. Vous devez ajouter des qualificateurs modifiés à l’espace de noms MS_409 (anglais) afin que le moniteur système puisse afficher correctement vos données de classe. Cela signifie que vous modifiez la définition de propriété en ajoutant un qualificateur Description avec du texte explicatif et renseignez la valeur DisplayName. Vous devez également ajouter des qualificateurs modifiés à tout autre espace de noms de paramètres régionaux pris en charge par votre classe. Si un utilisateur demande des données à partir d’un paramètre régional pour lequel il ne fournit pas de qualificateurs modifiés, WMI utilise par défaut les définitions spécifiées dans l’espace de noms MS_409.

  8. Créez une propriété de base pour toute propriété dont le type de compteur attend une valeur de base.

    Cette propriété suit immédiatement la propriété et est nommée propertyname**_Base**. Par exemple, la propriété moyenne AvgDiskBytesPerRead dans la classe Win32_PerfRawData_PerfDisk_LogicalDisk nécessite une propriété de base nommée AvgDiskBytesPerRead_Base pour compter le nombre d’exemples. Pour déterminer si le type de compteur que vous souhaitez utiliser nécessite une propriété de base, recherchez le type de compteur par nom ou par valeur décimale dans Types de compteurs de performances WMI.

  9. Assurez-vous que votre fournisseur satisfait aux exigences de performances.

Faire d’un fournisseur d’instance un fournisseur de haute performance