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 |