다음을 통해 공유


WMI 속성 한정자

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

다음은 키, 읽기, 쓰기, ValueMap 및 값같은 표준 MOF 한정자입니다. 이러한 형식 및 기타 표준 MOF 한정자에 대한 자세한 내용은 MOF 데이터 형식을 참조 하세요.

한정자 설명

key

데이터 항목이 클래스의 각 인스턴스를 고유하게 식별하는 키 속성임을 나타냅니다. InstanceName 속성만 키를 선언할 수 있습니다.

read

WMI 클라이언트가 데이터 항목을 읽을 수 있음을 나타냅니다.

write

WMI 클라이언트가 데이터 항목을 설정할 수 있음을 나타냅니다.

BitMap

BitValues에 지정된 해당 문자열 값의 비트 위치를 지정 합니다.

BitValues

데이터 항목에 설정된 비트를 나타내는 문자열 값(플래그 이름) 목록을 지정합니다. 플래그의 비트 위치는 BitMap지정된 해당 위치에 의해 정의됩니다.

DefineValues

WMI 도구 모음이 해당 #define 문 목록으로 컴파일하는 열거형 목록을 지정합니다.

DisplayInHex

속성 값을 표시하는 모든 WMI 클라이언트가 16진수로 표시되도록 지정합니다.

DisplayName("string")

WMI 클라이언트가 속성 이름으로 표시하는 데 사용할 수 있는 캡션을 지정합니다.

MaxLen(uint)

문자열 속성의 경우 MaxLen 은 문자열의 최대 길이를 문자 단위로 지정합니다. uint 값은 부호 없는 32비트 정수일 수 있습니다. MaxLen을 생략하거나 uint 가 0이면 문자열 길이가 무제한입니다.

이 데이터 항목에 사용할 수 있는 값 목록을 지정합니다. 데이터 항목이 열거형인 경우 ValueMap에는 값에 지정된 열거형 값에 해당하는 인덱스 값이 포함됩니다.

ValueMap

값에서 해당 문자열 값의 정수 값을 지정합니다.

WmiDataId(data-item-ID)

(필수) 데이터 블록 내의 데이터 항목을 식별합니다. 필요한 항목 InstanceNameActive를 제외한 블록의 모든 항목에 데이터 항목 ID를 할당해야 합니다. 데이터 항목 ID는 연속 계열에서 1부터 할당해야 합니다. 항목의 데이터 ID는 항목이 데이터 블록의 인스턴스에 나타나는 순서를 결정합니다. MOF 클래스 정의의 항목 순서는 관련이 없습니다.

WmiMethodId(method-item-ID)

데이터 블록 내의 메서드를 식별합니다.

WmiSizeIs("data-item-name")

이 데이터 항목의 가변 길이 배열에 있는 요소 수를 나타내는 이 블록에 있는 다른 데이터 항목의 이름을 지정합니다. WmiSizeIs 는 배열을 정의하는 데이터 항목에만 유효합니다.

WmiScale(scale-factor)

이 데이터 항목의 값을 반환할 때 드라이버에서 사용하는 배율 인수(10)를 지정합니다. 예를 들어 배율 인수가 5이면 드라이버에서 반환되는 값에 10을 곱합니다. WmiScale을 생략하면 배율 인수를 0으로 간주할 수 있습니다.

WmiTimeStamp

64비트 데이터 항목이 1601/1/1 이후 100나노초 단위의 타임스탬프를 지정합니다. WmiTimeStamp 는 64비트 데이터 항목에만 유효합니다.

WmiComplexity(level)

데이터 항목의 사용자 복잡성 수준을 나타내는 정수 값을 지정합니다. WMI 클라이언트는 이 값을 사용하여 초보 사용자가 사용할 수 있어야 하는 데이터 항목과 고급 사용자로 제한해야 하는 데이터 항목을 구분할 수 있습니다. 0은 최소값이고, 값이 높을수록 사용자 복잡성이 높아집니다. WmiComplexity 는 지정하지 않으면 기본적으로 0으로 설정됩니다.

WmiVolatility(interval)

이 데이터 항목의 업데이트 간격(밀리초)을 지정합니다. 예를 들어 데이터 항목이 1초 마다 한 번씩 업데이트되는 경우 간격 은 1000이 됩니다. WMI 클라이언트는 WmiVolatility를 확인하여 잠재적으로 새 값을 쿼리하는 빈도를 결정할 수 있습니다. WmiVolatility를 생략하면 간격이 정의되지 않습니다.

WmiEventTrigger( "data-item-name")

WMI 클라이언트가 이벤트에 대한 트리거 값을 정의하도록 설정할 수 있는 이벤트 블록의 데이터 항목 이름을 지정합니다. 예를 들어, 이벤트 TooHot이 WmiEventTrigger("TooHotTemperature")로 한정된 경우 WMI 클라이언트는 디바이스가 TooHotTemperature에 대해 사용자 지정 값에 도달했을 때 드라이버에 TooHot 이벤트를 보내도록 지시하도록 TooHotTemperature를 설정할 수 있습니다. 일반적으로 드라이버는 트리거 값을 정의합니다. WmiEventTrigger 데이터 항목을 노출하면 드라이버는 클라이언트가 특정 이벤트가 발생하는 시기를 제어할 수 있도록 합니다.

WmiEventRate("data-item-name")

이 이벤트가 전송되는 빈도를 제어하도록 WMI 클라이언트가 설정할 수 있는 이벤트 블록의 데이터 항목 이름을 지정합니다. 예를 들어 데이터 항목 TooHot이 WmiEventRate("SendEventRate")로 한정된 경우 WMI 클라이언트 사용자는 사용자 지정 간격으로 TooHot을 보내도록 드라이버에 지시하도록 SendEventRate를 설정할 수 있습니다.