Função IoWMIWriteEvent (wdm.h)

A rotina IoWMIWriteEvent fornece um determinado evento para os componentes WMI do modo de usuário para notificação.

Sintaxe

NTSTATUS IoWMIWriteEvent(
  [in, out] PVOID WnodeEventItem
);

Parâmetros

[in, out] WnodeEventItem

Ponteiro para uma estrutura WNODE_EVENT_ITEM a ser entregue aos componentes WMI do modo de usuário que solicitaram a notificação do evento.

Valor retornado

IoWMIWriteEvent retorna um código de status da seguinte lista:

Código de retorno Descrição
STATUS_SUCCESS
Indica que o WMI enfileira o evento com êxito para entrega nos componentes WMI do modo de usuário.
STATUS_UNSUCCESSFUL
Indica que os serviços WMI não estão disponíveis.
STATUS_BUFFER_OVERFLOW
Indica que o item de evento especificado excede o tamanho máximo permitido.
STATUS_INSUFFICIENT_RESOURCES
Indica que recursos insuficientes estavam disponíveis para o WMI enfileirar o evento para entrega.

Comentários

A estrutura WNODE_EVENT_ITEM alocada pelo chamador e passada em WnodeEventItem deve ser alocada do pool nãopagado. Se IoWMIWriteEvent retornar STATUS_SUCCESS, a memória do item de evento será liberada automaticamente pelo sistema. Se IoWMIWriteEvent retornar algo diferente de STATUS_SUCCESS, é responsabilidade do chamador liberar o buffer.

Os drivers devem chamar apenas IoWMIWriteEvent para eventos que foram habilitados para o WMI. Isso garante que haja um consumidor de evento aguardando indicação sobre esse evento.

Os chamadores dessa rotina devem estar em execução no IRQL <= APC_LEVEL, com uma exceção. Quando o membro Flags da estrutura WNODE_HEADER contém WNODE_FLAG_TRACED_GUID, IoWMIWriteEvent pode ser chamado em qualquer IRQL. (A estrutura WNODE_HEADER é um membro da estrutura WNODE_EVENT_ITEM à qual o parâmetro WnodeEventItem aponta.)

Requisitos

   
Cliente mínimo com suporte Disponível a partir do Windows 2000.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL (consulte a seção Comentários)

Confira também

IoWmiDeviceObjectToProviderId

WNODE_EVENT_ITEM