Função IoWMIWriteEvent (wdm.h)

  • Artigo

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.

Retornar valor

IoWMIWriteEvent retorna um código status da seguinte lista:

Código de retorno Descrição
STATUS_SUCCESS
 Indica que o WMI enfileirau com êxito o evento 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 só devem chamar IoWMIWriteEvent para eventos que foram habilitados para WMI. Isso garante que haja um consumidor de evento aguardando indicação sobre esse evento.

Os chamadores dessa rotina devem estar em execução em 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 para a qual o parâmetro WnodeEventItem aponta.)

Requisitos

Requisito Valor
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