Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La estructura 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 WNODE_HEADER que contiene información común a todas las estructuras de 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 WNODE_los datos XXX que se pasan o devuelven.
Observaciones
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_INSTANCEy WNODE_SINGLE_ITEM. Para obtener más información sobre las marcas, vea WNODE_HEADER.
El ProviderId miembro de la estructura de WNODE_HEADER para su uso en una estructura de WNODE_EVENT_ITEM debe inicializarse mediante IoWMIDeviceObjectToProviderId.
Un controlador solo genera eventos que ha habilitado anteriormente 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 una WNODE_EVENT_REFERENCE, que WMI usa para consultar el WNODE_EVENT_ITEMrelacionado. Para obtener más información sobre cómo definir y generar eventos WMI, vea Instrumental de administración de Windows.
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de | wmistr.h (incluya Wmistr.h) |