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

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

DUMMYUNIONNAME.TargetInstanceName

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

注解

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

在WNODE_EVENT_REFERENCE结构中使用的 WNODE_HEADER结构的ProviderId 成员应使用 IoWMIDeviceObjectToProviderId 进行初始化。

要求

另请参阅

IoWMIDeviceObjectToProviderId

WNODE_EVENT_ITEM

WNODE_HEADER