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 |