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

Confira também

PROVIDER_FILTER_INFO

TRACE_EVENT_INFO