структура WNODE_EVENT_ITEM (wmistr.h)

Статья
08/08/2023

Структура 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.