共用方式為


WNODE_EVENT_ITEM結構 (wmistr.h)

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

規格需求

需求
標頭 wmistr.h (包含 Wmistr.h)

另請參閱

IRP_MN_ENABLE_EVENTS

IoWMIDeviceObjectToProviderId

IoWMIWriteEvent

WNODE_ALL_DATA

WNODE_EVENT_REFERENCE

WNODE_HEADER

WNODE_SINGLE_INSTANCE

WNODE_SINGLE_ITEM