Квалификаторы свойств WMI

В следующей таблице перечислены обязательные и необязательные квалификаторы свойств MOF, которые можно использовать для определения элементов в данных или блоке событий WMI.

The following are standard MOF qualifiers: key, read, write, ValueMap, and Values. Дополнительные сведения об этих и других стандартных квалификаторов MOF см. в разделе "Типы данных MOF".

Qualifier Description

key

Указывает, что элемент данных является ключевым свойством, уникальным образом идентифицирующий каждый экземпляр класса. Только свойство InstanceName можно объявить ключ.

read

Указывает, что клиент WMI может считывать элемент данных.

write

Указывает, что клиент WMI может задать элемент данных.

BitMap

Specifies the bit positions of the corresponding string values that are specified in BitValues.

BitValues

Задает список строковых значений (имен флагов), представляющих биты, заданные в элементе данных. The bit position of a flag is defined by the corresponding position specified in BitMap.

DefineValues

Указывает перечислимый список, который набор инструментов WMI компилируется в соответствующий список операторов #define.

DisplayInHex

Указывает, что любой клиент WMI, отображающий значение свойства, должен сделать это в шестнадцатеричном формате.

DisplayName("string")

Указывает заголовок, который клиент WMI может использовать для отображения в качестве имени свойства.

MaxLen(uint)

For string properties, MaxLen specifies the maximum length of the string in characters. The uint value can be any 32-bit unsigned integer. If MaxLen is omitted, or uint is zero, then the length of the string is unlimited.

Values

Указывает список возможных значений для этого элемента данных. If the data item is an enumeration, ValueMap contains the index value that corresponds to the enumeration value specified in Values.

ValueMap

Specifies the integer values of the corresponding string values in Values.

WmiDataId(data-item-ID)

(обязательно) Определяет элемент данных в блоке данных. Data item IDs must be assigned to all items in a block except the required items InstanceName and Active. Идентификаторы элементов данных должны быть назначены в последовательном ряде, начиная с 1. Идентификатор данных элемента определяет порядок отображения элемента в экземпляре блока данных; Порядок элементов в определении класса MOF не имеет значения.

WmiMethodId(method-item-ID)

Определяет метод в блоке данных.

WmiSizeIs("data-item-name")

Указывает имя другого элемента данных в этом блоке, указывающее количество элементов массива переменной длины в этом элементе данных. WmiSizeIs is valid only for data items that define arrays.

WmiScale(scale-factor)

Указывает коэффициент масштабирования в качестве значения 10, используемый драйвером при возврате значения этого элемента данных. For example, if scale-factor is 5, the value returned by the driver is multiplied by 10⁵. If WmiScale is omitted, scale-factor can be assumed to be 0.

WmiTimeStamp

Указывает, что 64-разрядный элемент данных является меткой времени в единицах 100 nanoseconds с 1.1.1.1601. WmiTimeStamp is valid only for 64-bit data items.

WmiComplexity(level)

Задает целочисленное значение, которое выражает уровень сложности пользователя элемента данных. Клиенты WMI могут использовать это значение, чтобы различать элементы данных, которые должны быть доступны для начинающих пользователей и элементов данных, которые должны быть ограничены более сложными пользователями. Ноль — это минимальное значение, а более высокие значения указывают на более высокую сложность пользователя. WmiComplexity defaults to zero if not specified.

WmiVolatility(interval)

Задает интервал в миллисекундах между обновлениями этого элемента данных. For example, if a data item is updated once each second, interval would be 1000. A WMI client might check WmiVolatility to determine how often to query for a potentially new value. If WmiVolatility is omitted, interval is undefined.

WmiEventTrigger("data-item-name")

Указывает имя элемента данных в блоке событий, который клиент WMI может задать для определения значения триггера для события. For example, if the event TooHot is qualified with WmiEventTrigger("TooHotTemperature"), a WMI client could set TooHotTemperature to instruct the driver to send the TooHot event when the device reached the user-specified value for TooHotTemperature. Как правило, драйвер определяет значение триггера. By exposing a WmiEventTrigger data item, the driver allows a client to control when a particular event is fired.

WmiEventRate("data-item-name")

Указывает имя элемента данных в блоке событий, с помощью которого клиент WMI может задать частоту отправки этого события. For example, if the data item TooHot is qualified with WmiEventRate("SendEventRate"), a WMI client user could set SendEventRate to instruct the driver to send TooHot at the user-specified interval.
  • Last updated on