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 de WNODE_HEADER que contém informações comuns a todas as estruturas deXXX WNODE_, 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 o WNODE_XXX dados que estão sendo passados ou retornados.
Observações
O WnodeHeader membro 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_INSTANCEe WNODE_SINGLE_ITEM. Para obter mais informações sobre os sinalizadores, consulte WNODE_HEADER.
O ProviderId membro da estrutura WNODE_HEADER para uso em uma estrutura de 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 o WNODE_EVENT_ITEMrelacionado. Para obter mais informações sobre como definir e gerar eventos WMI, consulte de Instrumentação de Gerenciamento do Windows.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | wmistr.h (inclua Wmistr.h) |