Compartilhar via

Função IoWMIWriteEvent (wdm.h)

  • Artigo

A rotina de 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 de WNODE_EVENT_ITEM a ser entregue aos componentes WMI do modo de usuário que solicitaram a notificação do evento.

Valor de retorno

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 no 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.

Observações

A estrutura de WNODE_EVENT_ITEM alocada pelo chamador e passada 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 qualquer coisa diferente de STATUS_SUCCESS, é responsabilidade do chamador liberar o buffer.

Os drivers devem chamar apenas 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 no IRQL <= APC_LEVEL, com uma exceção. Quando os sinalizadores membro da estrutura WNODE_HEADER contiver 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

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

Consulte também

IoWmiDeviceObjectToProviderId

WNODE_EVENT_ITEM