estrutura WNODE_EVENT_ITEM (wmistr.h)
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.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | wmistr.h (inclua Wmistr.h) |