WNODE_EVENT_ITEM 结构 (wmistr.h)

项目
02/27/2024

WNODE_EVENT_ITEM 结构包含由事件驱动程序生成的数据。

语法

typedef struct tagWNODE_EVENT_ITEM {
  struct _WNODE_HEADER WnodeHeader;
} WNODE_EVENT_ITEM, *PWNODE_EVENT_ITEM;

成员

WnodeHeader

指定一个 WNODE_HEADER 结构，该结构包含所有 WNODE_XXX 结构共有的信息，例如缓冲区大小、表示与请求关联的数据块的 GUID，以及提供有关正在传递或返回 的 WNODE_XXX 数据信息的标志。

注解

WNODE_EVENT_ITEM 结构的 WnodeHeader 成员后跟一个结构，其类型取决于 WnodeHeader 中设置的标志。可能性包括 WNODE_ALL_DATA、 WNODE_SINGLE_INSTANCE和 WNODE_SINGLE_ITEM。有关标志的详细信息，请参阅 WNODE_HEADER。

应使用 IoWMIDeviceObjectToProviderId 初始化用于WNODE_EVENT_ITEM结构的WNODE_HEADER结构的 ProviderId 成员。

驱动程序仅生成之前为响应 IRP_MN_ENABLE_EVENTS 请求而启用的事件。若要生成事件，驱动程序调用 IoWMIWriteEvent 并将指针传递给 WNODE_EVENT_ITEM。 WMI 将事件排队，以便传递给为该事件注册的所有数据使用者。

为了获得最佳性能，事件的大小应较小。但是，如果事件的数据量超过注册表中定义的最大大小，驱动程序可以传递WNODE_EVENT_REFERENCE，WMI 使用该WNODE_EVENT_ITEM查询。有关定义和生成 WMI 事件的详细信息，请参阅 Windows Management Instrumentation。