структура 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.
Элемент ProviderId структуры WNODE_HEADER для использования в структуре WNODE_EVENT_ITEM следует инициализировать с помощью IoWMIDeviceObjectToProviderId.
Драйвер создает только события, которые он ранее включил в ответ на запрос IRP_MN_ENABLE_EVENTS. Чтобы создать событие, драйвер вызывает IoWMIWriteEvent и передает указатель на WNODE_EVENT_ITEM. WMI очереди события для доставки всем потребителям данных, зарегистрированным для этого события.
Для повышения производительности события должны быть небольшими. Однако если объем данных для события превышает максимальный размер, определенный в реестре, драйвер может передать WNODE_EVENT_REFERENCE, который WMI использует для запроса связанных WNODE_EVENT_ITEM. Дополнительные сведения об определении и создании событий WMI см. в инструментирования управления Windows.
Требования
| Требование | Ценность |
|---|---|
| заголовка | wmistr.h (include Wmistr.h) |