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) |