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 进行初始化。
要求
要求 | 值 |
---|---|
Header | wmistr.h (包括 Wmistr.h) |