WNODE_EVENT_ITEM結構 (wmistr.h)

發行項
03/01/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。

WNODE_HEADER結構的ProviderId 成員，應該使用 IoWMIDeviceObjectToProviderId 初始化WNODE_EVENT_ITEM結構。

驅動程式只會產生先前啟用的事件，以回應 IRP_MN_ENABLE_EVENTS 要求。若要產生事件，驅動程式會呼叫 IoWMIWriteEvent ，並將指標傳遞至 WNODE_EVENT_ITEM。 WMI 會將事件排入佇列，以傳遞至針對該事件註冊的所有數據取用者。

為了獲得最佳效能，事件的大小應該很小。不過，如果事件的數據量超過登錄中定義的大小上限，驅動程式可以傳遞 WNODE_EVENT_REFERENCE，WMI 會用來查詢相關的 WNODE_EVENT_ITEM。如需定義和產生 WMI 事件的詳細資訊，請參閱 Windows Management Instrumentation。