WNODE_EVENT_REFERENCE 구조체(wmistr.h)

WNODE_EVENT_REFERENCE 구조에는 WMI가 레지스트리에 설정된 이벤트 크기 제한을 초과하는 이벤트를 쿼리하는 데 사용할 수 있는 정보가 포함되어 있습니다.

구문

typedef struct tagWNODE_EVENT_REFERENCE {
  struct _WNODE_HEADER WnodeHeader;
  GUID                 TargetGuid;
  ULONG                TargetDataBlockSize;
  union {
    ULONG TargetInstanceIndex;
    WCHAR TargetInstanceName[];
  } DUMMYUNIONNAME;
} WNODE_EVENT_REFERENCE, *PWNODE_EVENT_REFERENCE;

멤버

WnodeHeader

버퍼 크기, 공급자 ID, 요청과 연결된 데이터 블록을 나타내는 GUID 및 전달되거나 반환되는 WNODE_XXX 데이터에 대한 정보를 제공하는 플래그와 같은 모든 WNODE_XXX 구조에 공통적인 정보를 포함하는 WNODE_HEADER 구조체입니다.

TargetGuid

쿼리할 이벤트를 나타내는 GUID를 나타냅니다.

TargetDataBlockSize

이벤트의 크기를 나타냅니다.

DUMMYUNIONNAME

DUMMYUNIONNAME.TargetInstanceIndex

이벤트의 정적 instance 이름 목록에 있는 인덱스입니다. 이 멤버는 이벤트 블록이 정적 instance 이름으로 등록되고 WnodeHeader.Flags에서 WNODE_FLAGS_STATIC_INSTANCE_NAMES 설정된 경우에만 유효합니다.

DUMMYUNIONNAME.TargetInstanceName

이벤트의 동적 instance 이름을 계산된 유니코드 문자열로 나타냅니다. 이 멤버는 WnodeHeader.Flags에서 WNODE_FLAGS_STATIC_INSTANCE_NAMES 명확하고 이벤트 블록이 동적 instance 이름으로 등록된 경우에만 유효합니다.

설명

이벤트의 데이터 양이 레지스트리의 최대 크기 집합을 초과하는 경우 드라이버는 WMI가 이벤트를 가져오기 위해 쿼리할 수 있는 WNODE_EVENT_ITEM 지정하는 WNODE_EVENT_REFERENCE 생성할 수 있습니다. WMI 이벤트를 정의하고 생성하는 방법에 대한 자세한 내용은 WMI 구현을 참조하세요.

WNODE_EVENT_REFERENCE 구조체에 사용할 WNODE_HEADER구조체의 ProviderId 멤버는 IoWMIDeviceObjectToProviderId를 사용하여 초기화해야 합니다.

요구 사항

추가 정보

IoWMIDeviceObjectToProviderId

WNODE_EVENT_ITEM

WNODE_HEADER