estructura WNODE_EVENT_ITEM (wmistr.h)

Artículo
02/27/2024

La estructura de WNODE_EVENT_ITEM contiene los datos generados por un controlador para un evento.

Sintaxis

typedef struct tagWNODE_EVENT_ITEM {
  struct _WNODE_HEADER WnodeHeader;
} WNODE_EVENT_ITEM, *PWNODE_EVENT_ITEM;

Miembros

WnodeHeader

Especifica una estructura de WNODE_HEADER que contiene información común a todas las estructuras WNODE_XXX , como el tamaño del búfer, el GUID que representa un bloque de datos asociado a una solicitud y marcas que proporcionan información sobre los datos WNODE_XXX que se pasan o devuelven.

Comentarios

El miembro WnodeHeader de la estructura WNODE_EVENT_ITEM va seguido de una estructura cuyo tipo depende de las marcas establecidas en WnodeHeader. Entre las posibilidades se incluyen WNODE_ALL_DATA, WNODE_SINGLE_INSTANCE y WNODE_SINGLE_ITEM. Para obtener más información sobre las marcas, vea WNODE_HEADER.

El miembro ProviderId de la estructura WNODE_HEADER para su uso en una estructura de WNODE_EVENT_ITEM debe inicializarse mediante IoWMIDeviceObjectToProviderId.

Un controlador solo genera eventos que se han habilitado previamente en respuesta a una solicitud de IRP_MN_ENABLE_EVENTS . Para generar un evento, un controlador llama a IoWMIWriteEvent y pasa un puntero al WNODE_EVENT_ITEM. WMI pone en cola el evento para su entrega a todos los consumidores de datos registrados para ese evento.

Para obtener el mejor rendimiento, los eventos deben tener un tamaño pequeño. Sin embargo, si la cantidad de datos de un evento supera el tamaño máximo definido en el Registro, un controlador puede pasar un WNODE_EVENT_REFERENCE, que WMI usa para consultar el WNODE_EVENT_ITEM relacionado. Para obtener más información sobre cómo definir y generar eventos WMI, consulta Instrumental de administración de Windows.