estructura WNODE_EVENT_REFERENCE (wmistr.h)

  • Artículo

La estructura de WNODE_EVENT_REFERENCE contiene información que WMI puede usar para consultar un evento que supere el límite de tamaño de evento establecido en el Registro.

Sintaxis

typedef struct tagWNODE_EVENT_REFERENCE {
  struct _WNODE_HEADER WnodeHeader;
  GUID                 TargetGuid;
  ULONG                TargetDataBlockSize;
  union {
    ULONG TargetInstanceIndex;
    WCHAR TargetInstanceName[];
  } DUMMYUNIONNAME;
} WNODE_EVENT_REFERENCE, *PWNODE_EVENT_REFERENCE;

Miembros

WnodeHeader

Es una estructura WNODE_HEADER que contiene información común a todas las estructuras WNODE_XXX , como el tamaño del búfer, el identificador de proveedor, 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.

TargetGuid

Indica el GUID que representa el evento que se va a consultar.

TargetDataBlockSize

Indica el tamaño del evento.

DUMMYUNIONNAME

DUMMYUNIONNAME.TargetInstanceIndex

Indica el índice en la lista del controlador de nombres de instancia estáticos para el evento. Este miembro solo es válido si el bloque de eventos se registró con nombres de instancia estáticos y WNODE_FLAGS_STATIC_INSTANCE_NAMES se establece en WnodeHeader.Flags.

DUMMYUNIONNAME.TargetInstanceName

Indica el nombre de instancia dinámico del evento como una cadena Unicode contada. Este miembro solo es válido si WNODE_FLAGS_STATIC_INSTANCE_NAMES está claro en WnodeHeader.Flags y el bloque de eventos se registró con nombres de instancia dinámicos.

Comentarios

Si la cantidad de datos de un evento supera el tamaño máximo establecido en el Registro, un controlador puede generar un WNODE_EVENT_REFERENCE que especifique un WNODE_EVENT_ITEM que WMI puede consultar para obtener el evento. Para obtener más información sobre cómo definir y generar eventos WMI, vea Implementación de WMI.

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

Requisitos

Requisito Valor
Header wmistr.h (incluye Wmistr.h)

Consulte también

IoWMIDeviceObjectToProviderId

WNODE_EVENT_ITEM

WNODE_HEADER