struttura EVENT_PROPERTY_INFO (tdh.h)

Fornisce informazioni su una singola proprietà dell'evento o del filtro.

Sintassi

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;

Members

Flags

Flag che indicano se la proprietà è contenuta in una struttura o in una matrice. Per i valori possibili, vedere l'enumerazione PROPERTY_FLAGS .

NameOffset

Offset a una stringa Unicode con terminazione Null contenente il nome della proprietà. Se si tratta di una proprietà di evento, l'offset proviene dall'inizio della struttura TRACE_EVENT_INFO . Se si tratta di una proprietà di filtro, l'offset proviene dall'inizio della struttura PROVIDER_FILTER_INFO .

nonStructType

Utilizzare questi membri se il flag PropertyStruct in Flags non è impostato; in caso contrario, utilizzare il membro structType .

nonStructType.InType

Tipo di dati di questa proprietà nell'input. Per una descrizione di questi tipi, vedere Osservazioni in InputType.

Per le descrizioni di questi tipi, vedere Qualificatori MOF di traccia eventi.

TdhGetPropertySizeTdhGetPropertySize

nonStructType.OutType

Formato di output per questa proprietà. Se il valore è TDH_OUTTYPE_NULL, usare in type come formato di output. Per una descrizione di questi tipi, vedere Osservazioni in InputType.

Per le descrizioni di questi tipi, vedere Qualificatori MOF di traccia eventi.

nonStructType.MapNameOffset

Offset dall'inizio della struttura TRACE_EVENT_INFO a una stringa Unicode con terminazione Null contenente il nome del valore dell'attributo map. Puoi passare questa stringa a TdhGetEventMapInformation per recuperare informazioni sulla mappa dei valori.

structType

Utilizzare questi membri se il flag PropertyStruct in Flags è impostato; in caso contrario, utilizzare il membro nonStructType .

structType.StructStartIndex

Indice in base zero all'elemento della matrice di proprietà che contiene il primo membro della struttura.

structType.NumOfStructMembers

Numero di membri nella struttura.

structType.padding

Non usato.

customSchemaType

Utilizzare questi membri se il flag PropertyHasCustomSchema in Flags è impostato; in caso contrario, utilizzare il membro nonStructType .

customSchemaType.InType

customSchemaType.OutType

Formato di output per questa proprietà. Se il valore è TDH_OUTTYPE_NULL, usare in type come formato di output. Per una descrizione di questi tipi, vedere Osservazioni in InputType.

Per le descrizioni di questi tipi, vedere Qualificatori MOF di traccia eventi.

customSchemaType.CustomSchemaOffset

Offset (in byte) dall'inizio della struttura TRACE_EVENT_INFO alle informazioni dello schema personalizzate. Le informazioni dello schema personalizzate conterranno un identificatore di protocollo a 2 byte, seguito da una lunghezza dello schema a 2 byte, seguita dallo schema.

count

Numero di elementi nella matrice. Si noti che questo valore è 1 per le proprietà non definite come matrice.

countPropertyIndex

Indice in base zero all'elemento della matrice di proprietà che contiene il numero di elementi nella matrice. Utilizzare questo membro se il flag PropertyParamCount in Flags è impostato; in caso contrario, utilizzare il membro count .

length

Dimensioni della proprietà, in byte. Si noti che i tipi di dimensioni variabili, ad esempio stringhe e dati binari, hanno una lunghezza pari a zero, a meno che la proprietà non abbia l'attributo length per indicare in modo esplicito la relativa lunghezza reale. Le strutture hanno una lunghezza pari a zero.

lengthPropertyIndex

Indice in base zero all'elemento della matrice di proprietà che contiene il valore size di questa proprietà. Utilizzare questo membro se è impostato il flag PropertyParamLength in Flags ; in caso contrario, utilizzare il membro length .

Reserved

Riservato.

Tags

Valore a 28 bit associato ai metadati del campo. Questo valore è valido solo se è impostato il flag PropertyHasTags . Questo valore può essere usato dal provider di eventi per associare dati semantici aggiuntivi a un campo da utilizzare da uno strumento di elaborazione eventi. Ad esempio, un valore di tag pari a 1 potrebbe indicare che il campo contiene un nome utente. La semantica di tutti i valori in questo campo è definita dal provider di eventi.

Commenti

I filtri non supportano mappe, strutture o matrici.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Intestazione tdh.h

Vedi anche

PROVIDER_FILTER_INFO

TRACE_EVENT_INFO