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

一个 WNODE_HEADER 结构,其中包含所有 WNODE_XXX 结构共有的信息,例如缓冲区大小、提供程序 ID、表示与请求关联的数据块的 GUID,以及提供有关要传递或返回 WNODE_XXX 数据的信息的标志。

TargetGuid

指示表示要查询的事件的 GUID。

TargetDataBlockSize

指示事件的大小。

DUMMYUNIONNAME

DUMMYUNIONNAME.TargetInstanceIndex

指示索引到事件的驱动程序静态实例名称列表中。 仅当事件块使用静态实例名称注册并且WNODE_FLAGS_STATIC_INSTANCE_NAMES在 WnodeHeader.Flags中设置时,此成员才有效。

DUMMYUNIONNAME.TargetInstanceName

指示事件的动态实例名称作为计数的 Unicode 字符串。 仅当 WnodeHeader.Flags 中清除WNODE_FLAGS_STATIC_INSTANCE_NAMES并且事件块已注册到动态实例名称时,此成员才有效。

言论

如果事件的数据量超过注册表中设置的最大大小,驱动程序可以生成一个 WNODE_EVENT_REFERENCE,该 WNODE_EVENT_REFERENCE 指定 WMI 可以查询以获取事件的 WNODE_EVENT_ITEM。 有关定义和生成 WMI 事件的详细信息,请参阅 实现 WMI

应使用 IoWMIDeviceObjectToProviderId初始化 WNODE_HEADER 结构的 ProviderId 成员,以便在 WNODE_EVENT_REFERENCE 结构中使用。

要求

要求 价值
标头 wmistr.h (包括 Wmistr.h)

另请参阅

IoWMIDeviceObjectToProviderId

WNODE_EVENT_ITEM

WNODE_HEADER