WNODE_EVENT_REFERENCE 結構 (wmistr.h)
WNODE_EVENT_REFERENCE 結構包含 WMI 可用來查詢超過登錄中所設定事件大小限制的事件的資訊。
語法
typedef struct tagWNODE_EVENT_REFERENCE {
struct _WNODE_HEADER WnodeHeader;
GUID TargetGuid;
ULONG TargetDataBlockSize;
union {
ULONG TargetInstanceIndex;
WCHAR TargetInstanceName[];
} DUMMYUNIONNAME;
} WNODE_EVENT_REFERENCE, *PWNODE_EVENT_REFERENCE;
成員
WnodeHeader
這是 一個WNODE_HEADER 結構,其中包含所有 WNODE_XXX 結構通用的資訊,例如緩衝區大小、提供者標識符、代表與要求相關聯的數據區塊的 GUID,以及提供所傳遞或傳回 之WNODE_XXX 數據相關信息的旗標。
TargetGuid
指出表示要查詢之事件的 GUID。
TargetDataBlockSize
指出事件的大小。
DUMMYUNIONNAME
DUMMYUNIONNAME.TargetInstanceIndex
指出索引到事件的驅動程式靜態實例名稱清單中。 只有當事件區塊已註冊靜態實例名稱,且WNODE_FLAGS_STATIC_INSTANCE_NAMES是在 WnodeHeader.Flags 中設定時,這個成員才有效。
DUMMYUNIONNAME.TargetInstanceName
以計算 Unicode 字串表示事件的動態實例名稱。 只有在 WnodeHeader.Flags 中清除WNODE_FLAGS_STATIC_INSTANCE_NAMES且事件區塊已向動態實例名稱註冊時,這個成員才有效。
備註
如果事件的數據量超過登錄中設定的大小上限,驅動程式可以產生 WNODE_EVENT_REFERENCE ,指定 WMI 可以查詢以取得事件的 WNODE_EVENT_ITEM 。 如需定義及產生 WMI 事件的詳細資訊,請參閱 實作 WMI。
WNODE_EVENT_REFERENCE 結構中使用的 WNODE_HEADER 結構的 ProviderId 成員應該使用 IoWMIDeviceObjectToProviderId 初始化。
規格需求
需求 | 值 |
---|---|
標頭 | wmistr.h (包括 Wmistr.h) |