다음을 통해 공유


WMI 속성 한정자

다음 표에서는 WMI 데이터 또는 이벤트 블록에서 항목을 정의하는 데 사용할 수 있는 필수 및 선택적 MOF 속성 한정자를 나열합니다.

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 클라이언트가 16진수로 표시되도록 지정합니다.

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. 데이터 항목 ID는 연속 계열에서 1부터 할당해야 합니다. 항목의 데이터 ID는 항목이 데이터 블록의 인스턴스에 나타나는 순서를 결정합니다. 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비트 데이터 항목이 1601/1/1 이후 100나노초 단위의 타임스탬프를 지정합니다. WmiTimeStamp is valid only for 64-bit data items.

WmiComplexity(level)

데이터 항목의 사용자 복잡성 수준을 나타내는 정수 값을 지정합니다. WMI 클라이언트는 이 값을 사용하여 초보 사용자가 사용할 수 있어야 하는 데이터 항목과 고급 사용자로 제한해야 하는 데이터 항목을 구분할 수 있습니다. 0은 최소값이고, 값이 높을수록 사용자 복잡성이 높아집니다. 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.