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.
Retornar valor
IoWMIWriteEvent retorna um código status da seguinte lista:
| Código de retorno | Descrição |
|---|---|
|
Indica que o WMI enfileirau com êxito o evento para entrega nos componentes WMI do modo de usuário. |
|
Indica que os serviços WMI não estão disponíveis. |
|
Indica que o item de evento especificado excede o tamanho máximo permitido. |
|
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) |