Partager via


Qualificateurs de classe WMI

Le tableau suivant répertorie les qualificateurs de classe MOF obligatoires et facultatifs qui peuvent être utilisés pour décrire les blocs de données WMI d’un pilote et les blocs d’événements.

An embedded class, which is a class used solely as a data item in another class and not exposed as a WMI data block, requires only the WMI and Guid qualifiers. Les autres qualificateurs ne sont pas pertinents pour les classes incorporées et sont ignorés. Pour plus d’informations sur les classes incorporées, consultez Éléments de données WMI définis par le pilote.

Dynamic and Static are standard MOF qualifiers. Pour plus d’informations sur les autres qualificateurs MOF standard, consultez le Kit de développement logiciel (SDK) Microsoft Windows.

Qualifier Description

Dynamic

Indique que le fournisseur de données fournit des instances du bloc de données au moment de l’exécution, plutôt que de fournir des instances de données statiques dans le fichier MOF. All data and event blocks that a driver registers with WMI must be defined with the Dynamic qualifier.

Static

Indique que le fournisseur de données fournit des instances de données statiques dans le fichier MOF, plutôt que de fournir des instances du bloc de données au moment de l’exécution. Un pilote n’inscrit pas de blocs de données statiques avec WMI, car les données statiques résident dans la base de données WMI. Classes marked as Static in the MOF file should not be registered by the driver's IRP_MN_REGINFO or IRP_MN_REGINFO_EX handlers.

Provider("WMIProv")

(Obligatoire) Indique que le fournisseur de la classe est un fournisseur WMI.

WMI

(Obligatoire) Indique que la classe est une classe WMI.

Description("description-string")

(Optional) Specifies a description of the block for the locale specified by the Locale qualifier. S’il est défini, les clients WMI peuvent afficher la chaîne de description aux utilisateurs. A driver writer can use Description to document a class.

Guid("guid-string")

(Obligatoire) Spécifie le GUID, au format de chaîne, qui identifie de façon unique le bloc sur WMI. Un enregistreur de pilotes doit générer un GUID pour chaque bloc de données dans le fichier MOF du pilote, à l’aide de guidgen.exe ou de uuidgen.exe (qui sont inclus dans le Kit de développement logiciel (SDK) Windows). Un pilote transmet cette valeur au format GUID à WMI lorsque le pilote inscrit ses blocs. WMI utilise ensuite le GUID pour rechercher la définition du bloc dans la ressource MOF du pilote.

Locale("MS</strong>locale-identifier")

(Optional) Specifies the language identifier and locale for the string specified by Description. For example, a locale-identifier of 0x409 specifies American English. Un seul fichier MOF peut contenir des blocs avec des paramètres régionaux différents, mais généralement tous les blocs d’un fichier MOF ont les mêmes paramètres régionaux.

WmiExpense(expense-value)

(Facultatif) Spécifie le nombre moyen de cycles processeur nécessaires pour collecter des données pour le bloc de données. For example, a WMI client might check a data block's WmiExpense value to determine how often to query for its data. If WmiExpense is omitted, expense-value is assumed to be 0. WmiExpense is unrelated to registering a data block as expensive to collect.