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 相關信息的旗標。
言論
WnodeHeader 成員 WNODE_EVENT_ITEM 結構後面接著一個結構,其類型取決於 WnodeHeader中所設定的旗標。 可能性包括 WNODE_ALL_DATA、WNODE_SINGLE_INSTANCE和 WNODE_SINGLE_ITEM。 如需旗標的詳細資訊,請參閱 WNODE_HEADER。
ProviderIdWNODE_HEADER 結構的成員,應該使用 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) |