Función IoWMIWriteEvent (wdm.h)

  • Artículo

La rutina IoWMIWriteEvent entrega un evento determinado a los componentes WMI en modo de usuario para la notificación.

Sintaxis

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

Parámetros

[in, out] WnodeEventItem

Puntero a una estructura de WNODE_EVENT_ITEM que se va a entregar a los componentes WMI en modo de usuario que solicitaron la notificación del evento.

Valor devuelto

IoWMIWriteEvent devuelve un código de estado de la lista siguiente:

Código devuelto Descripción
STATUS_SUCCESS
 Indica que WMI ha puesto en cola correctamente el evento para su entrega a los componentes WMI en modo de usuario.
STATUS_UNSUCCESSFUL
 Indica que los servicios WMI no están disponibles.
STATUS_BUFFER_OVERFLOW
 Indica que el elemento de evento especificado supera el tamaño máximo permitido.
STATUS_INSUFFICIENT_RESOURCES
 Indica que los recursos insuficientes estaban disponibles para que WMI ponera en cola el evento para la entrega.

Comentarios

La estructura WNODE_EVENT_ITEM asignada por el autor de la llamada y que se pasa en WnodeEventItem debe asignarse desde un grupo no paginado. Si IoWMIWriteEvent devuelve STATUS_SUCCESS, el sistema liberará automáticamente la memoria del elemento de evento. Si IoWMIWriteEvent devuelve algo distinto de STATUS_SUCCESS, es responsabilidad del autor de la llamada liberar el búfer.

Los controladores solo deben llamar a IoWMIWriteEvent para eventos que se han habilitado para WMI. Esto garantiza que haya un consumidor de eventos esperando la indicación de ese evento.

Los autores de llamadas de esta rutina deben ejecutarse en IRQL <= APC_LEVEL, con una excepción. Cuando el miembro Flags de la estructura WNODE_HEADER contiene WNODE_FLAG_TRACED_GUID, se puede llamar a IoWMIWriteEvent en cualquier IRQL. (La estructura WNODE_HEADER es un miembro de la estructura WNODE_EVENT_ITEM a la que apunta el parámetro WnodeEventItem ).

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows 2000.
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL <= APC_LEVEL (consulte la sección Comentarios)

Consulte también

IoWmiDeviceObjectToProviderId

WNODE_EVENT_ITEM