estrutura EVENT_PROPERTY_INFO (tdh.h)
Fornece informações sobre uma única propriedade do evento ou filtro.
Sintaxe
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;
Membros
Flags
Sinalizadores que indicam se a propriedade está contida em uma estrutura ou matriz. Para obter os valores possíveis, consulte a enumeração PROPERTY_FLAGS .
NameOffset
Deslocamento para uma cadeia de caracteres Unicode terminada em nulo que contém o nome da propriedade. Se essa for uma propriedade de evento, o deslocamento será desde o início da estrutura TRACE_EVENT_INFO . Se essa for uma propriedade de filtro, o deslocamento será desde o início da estrutura PROVIDER_FILTER_INFO .
nonStructType
Use esses membros se o sinalizador PropertyStruct em Flags não estiver definido; caso contrário, use o membro structType .
nonStructType.InType
Tipo de dados dessa propriedade na entrada. Para obter uma descrição desses tipos, consulte Comentários em InputType.
Para obter descrições desses tipos, consulte Qualificadores de MOF de Rastreamento de Eventos.
TdhGetPropertySizeTdhGetPropertySize
nonStructType.OutType
Formato de saída para essa propriedade. Se o valor for TDH_OUTTYPE_NULL, use o no tipo como o formato de saída. Para obter uma descrição desses tipos, consulte Comentários em InputType.
Para obter descrições desses tipos, consulte Qualificadores de MOF de Rastreamento de Eventos.
nonStructType.MapNameOffset
Deslocamento do início da estrutura TRACE_EVENT_INFO para uma cadeia de caracteres Unicode terminada em nulo que contém o nome do valor do atributo do mapa. Você pode passar essa cadeia de caracteres para TdhGetEventMapInformation para recuperar informações sobre o mapa de valores.
structType
Use esses membros se o sinalizador PropertyStruct em Flags estiver definido; caso contrário, use o membro nonStructType .
structType.StructStartIndex
Índice baseado em zero para o elemento da matriz de propriedades que contém o primeiro membro da estrutura.
structType.NumOfStructMembers
Número de membros na estrutura.
structType.padding
Não usado.
customSchemaType
Use esses membros se o sinalizador PropertyHasCustomSchema em Flags estiver definido; caso contrário, use o membro nonStructType .
customSchemaType.InType
customSchemaType.OutType
Formato de saída para essa propriedade. Se o valor for TDH_OUTTYPE_NULL, use o no tipo como o formato de saída. Para obter uma descrição desses tipos, consulte Comentários em InputType.
Para obter descrições desses tipos, consulte Qualificadores de MOF de Rastreamento de Eventos.
customSchemaType.CustomSchemaOffset
Deslocamento (em bytes) do início da estrutura TRACE_EVENT_INFO para as informações de esquema personalizadas. As informações de esquema personalizadas conterão um identificador de protocolo de 2 bytes, seguido por um comprimento de esquema de 2 bytes, seguido pelo esquema.
count
Número de elementos na matriz. Observe que esse valor é 1 para propriedades que não são definidas como uma matriz.
countPropertyIndex
Índice baseado em zero para o elemento da matriz de propriedades que contém o número de elementos na matriz. Use esse membro se o sinalizador PropertyParamCount em Flags estiver definido; caso contrário, use o membro count .
length
Tamanho da propriedade, em bytes. Observe que tipos de tamanho variável, como cadeias de caracteres e dados binários, têm um comprimento de zero, a menos que a propriedade tenha atributo de comprimento para indicar explicitamente seu comprimento real. As estruturas têm um comprimento de zero.
lengthPropertyIndex
Índice baseado em zero para o elemento da matriz de propriedades que contém o valor de tamanho dessa propriedade. Use esse membro se o sinalizador PropertyParamLength em Flags estiver definido; caso contrário, use o membro length .
Reserved
Reservado.
Tags
Um valor de 28 bits associado aos metadados do campo. Esse valor só será válido se o sinalizador PropertyHasTags estiver definido. Esse valor pode ser usado pelo provedor de eventos para associar dados semânticos adicionais a um campo para uso por uma ferramenta de processamento de eventos. Por exemplo, um valor de marca de 1 pode indicar que o campo contém um nome de usuário. A semântica de quaisquer valores nesse campo é definida pelo provedor de eventos.
Comentários
Os filtros não dão suporte a mapas, estruturas ou matrizes.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Cabeçalho | tdh.h |