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_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。
規格需求
需求 | 值 |
---|---|
標頭 | wmistr.h (包含 Wmistr.h) |