Compartir a través de


EVENT_PROPERTY_INFO estructura (tdh.h)

Proporciona información sobre una sola propiedad del evento o filtro.

Sintaxis

typedef struct _EVENT_PROPERTY_INFO {
  PROPERTY_FLAGS Flags;
  ULONG          NameOffset;
  union {
    struct {
      USHORT InType;
      USHORT OutType;
      ULONG  MapNameOffset;
    } nonStructType;
    struct {
      USHORT StructStartIndex;
      USHORT NumOfStructMembers;
      ULONG  padding;
    } structType;
    struct {
      USHORT InType;
      USHORT OutType;
      ULONG  CustomSchemaOffset;
    } customSchemaType;
  };
  union {
    USHORT count;
    USHORT countPropertyIndex;
  };
  union {
    USHORT length;
    USHORT lengthPropertyIndex;
  };
  union {
    ULONG Reserved;
    struct {
      ULONG Tags : 28;
    };
  };
} EVENT_PROPERTY_INFO;

Miembros

Flags

Marcas que indican si la propiedad está contenida en una estructura o matriz. Para conocer los valores posibles, consulte la enumeración PROPERTY_FLAGS .

NameOffset

Desplazamiento a una cadena Unicode terminada en null que contiene el nombre de la propiedad. Si se trata de una propiedad de evento, el desplazamiento es desde el principio de la estructura TRACE_EVENT_INFO . Si se trata de una propiedad de filtro, el desplazamiento es desde el principio de la estructura PROVIDER_FILTER_INFO .

nonStructType

Use estos miembros si no se establece la marca PropertyStruct en Flags ; En caso contrario, use el miembro structType .

nonStructType.InType

Tipo de datos de esta propiedad en la entrada. Para obtener una descripción de estos tipos, vea Comentarios en InputType.

Para obtener descripciones de estos tipos, vea Calificadores MOF de seguimiento de eventos.

TdhGetPropertySizeTdhGetPropertySize

nonStructType.OutType

Formato de salida para esta propiedad. Si el valor es TDH_OUTTYPE_NULL, use en el tipo como formato de salida. Para obtener una descripción de estos tipos, vea Comentarios en InputType.

Para obtener descripciones de estos tipos, vea Calificadores MOF de seguimiento de eventos.

nonStructType.MapNameOffset

Desfase desde el principio de la estructura TRACE_EVENT_INFO a una cadena Unicode terminada en null que contiene el nombre del valor del atributo de mapa. Puede pasar esta cadena a TdhGetEventMapInformation para recuperar información sobre el mapa de valores.

structType

Use estos miembros si se establece la marca PropertyStruct en Flags ; En caso contrario, use el miembro nonStructType .

structType.StructStartIndex

Índice de base cero al elemento de la matriz de propiedades que contiene el primer miembro de la estructura.

structType.NumOfStructMembers

Número de miembros de la estructura.

structType.padding

No se usa.

customSchemaType

Use estos miembros si se establece la marca PropertyHasCustomSchema en Flags ; En caso contrario, use el miembro nonStructType .

customSchemaType.InType

customSchemaType.OutType

Formato de salida para esta propiedad. Si el valor es TDH_OUTTYPE_NULL, use en el tipo como formato de salida. Para obtener una descripción de estos tipos, vea Comentarios en InputType.

Para obtener descripciones de estos tipos, vea Calificadores MOF de seguimiento de eventos.

customSchemaType.CustomSchemaOffset

Desplazamiento (en bytes) desde el principio de la estructura de TRACE_EVENT_INFO a la información de esquema personalizada. La información del esquema personalizado contendrá un identificador de protocolo de 2 bytes, seguido de una longitud de esquema de 2 bytes, seguida del esquema.

count

Cantidad de elementos en la matriz. Tenga en cuenta que este valor es 1 para las propiedades que no se definen como una matriz.

countPropertyIndex

Índice de base cero al elemento de la matriz de propiedades que contiene el número de elementos de la matriz. Use este miembro si se establece la marca PropertyParamCount en Flags ; en caso contrario, use el miembro count .

length

Tamaño de la propiedad, en bytes. Tenga en cuenta que los tipos de tamaño variable, como cadenas y datos binarios, tienen una longitud de cero a menos que la propiedad tenga el atributo length para indicar explícitamente su longitud real. Las estructuras tienen una longitud de cero.

lengthPropertyIndex

Índice de base cero al elemento de la matriz de propiedades que contiene el valor de tamaño de esta propiedad. Utilice este miembro si se establece la marca PropertyParamLength en Flags ; de lo contrario, use el miembro length .

Reserved

Reservado.

Tags

Valor de 28 bits asociado a los metadatos del campo. Este valor solo es válido si se establece la marca PropertyHasTags . El proveedor de eventos puede usar este valor para asociar datos semánticos adicionales a un campo para que lo use una herramienta de procesamiento de eventos. Por ejemplo, un valor de etiqueta de 1 podría indicar que el campo contiene un nombre de usuario. La semántica de cualquier valor de este campo se define mediante el proveedor de eventos.

Comentarios

Los filtros no admiten mapas, estructuras ni matrices.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado tdh.h

Consulte también

PROVIDER_FILTER_INFO

TRACE_EVENT_INFO