estrutura WNODE_EVENT_ITEM (wmistr.h)

Artigo
02/27/2024

A estrutura WNODE_EVENT_ITEM contém dados gerados por um driver para um evento.

Sintaxe

typedef struct tagWNODE_EVENT_ITEM {
  struct _WNODE_HEADER WnodeHeader;
} WNODE_EVENT_ITEM, *PWNODE_EVENT_ITEM;

Membros

WnodeHeader

Especifica uma estrutura WNODE_HEADER que contém informações comuns a todas as estruturas WNODE_XXX , como o tamanho do buffer, o GUID que representa um bloco de dados associado a uma solicitação e sinalizadores que fornecem informações sobre os dados WNODE_XXX que estão sendo passados ou retornados.

Comentários

O membro WnodeHeader da estrutura WNODE_EVENT_ITEM é seguido por uma estrutura cujo tipo depende dos sinalizadores definidos em WnodeHeader. As possibilidades incluem WNODE_ALL_DATA, WNODE_SINGLE_INSTANCE e WNODE_SINGLE_ITEM. Para obter mais informações sobre os sinalizadores, consulte WNODE_HEADER.

O membro ProviderId da estrutura WNODE_HEADER para uso em uma estrutura WNODE_EVENT_ITEM deve ser inicializado usando IoWMIDeviceObjectToProviderId.

Um driver gera apenas eventos que ele habilitou anteriormente em resposta a uma solicitação de IRP_MN_ENABLE_EVENTS . Para gerar um evento, um driver chama IoWMIWriteEvent e passa um ponteiro para o WNODE_EVENT_ITEM. O WMI enfileira o evento para entrega a todos os consumidores de dados registrados para esse evento.

Para obter o melhor desempenho, os eventos devem ser pequenos em tamanho. No entanto, se a quantidade de dados de um evento exceder o tamanho máximo definido no registro, um driver poderá passar um WNODE_EVENT_REFERENCE, que o WMI usa para consultar as WNODE_EVENT_ITEM relacionadas. Para obter mais informações sobre como definir e gerar eventos WMI, consulte Instrumentação de Gerenciamento do Windows.