ENABLE_TRACE_PARAMETERS_V1 struttura (evntrace.h)
La struttura ENABLE_TRACE_PARAMETERS_V1 contiene informazioni usate per abilitare un provider tramite EnableTraceEx2. Questa struttura è obsoleta. Usare invece ENABLE_TRACE_PARAMETERS .
Sintassi
typedef struct _ENABLE_TRACE_PARAMETERS_V1 {
ULONG Version;
ULONG EnableProperty;
ULONG ControlFlags;
GUID SourceId;
PEVENT_FILTER_DESCRIPTOR EnableFilterDesc;
} ENABLE_TRACE_PARAMETERS_V1, *PENABLE_TRACE_PARAMETERS_V1;
Members
Version
Impostare su ENABLE_TRACE_PARAMETERS_VERSION (1).
EnableProperty
Informazioni facoltative che ETW possono includere durante la scrittura dell'evento. I dati sono scritti nella sezione dell'elemento di dati esteso dell'evento. Per includere le informazioni facoltative, specificare uno o più flag seguenti; in caso contrario, impostare su zero.
EVENT_ENABLE_PROPERTY_SID
Includere nei dati estesi l'identificatore di sicurezza (SID) dell'utente.
EVENT_ENABLE_PROPERTY_TS_ID
Includere nei dati estesi l'identificatore della sessione del terminale.
EVENT_ENABLE_PROPERTY_STACK_TRACE
Aggiungere una traccia dello stack di chiamate ai dati estesi degli eventi scritti usando EventWrite.
Nota
ETW rilascia l'evento se la dimensione totale dell'evento supera 64K. Se il provider registra gli eventi di chiusura delle dimensioni fino a 64K, è possibile che l'abilitazione dell'acquisizione dello stack causerà la perdita dell'evento.
Se lo stack è più lungo del numero massimo di fotogrammi (192), i fotogrammi verranno tagliati dalla parte inferiore dello stack.
Per i consumer, gli eventi includono il EVENT_EXTENDED_ITEM_STACK_TRACE32 o EVENT_EXTENDED_ITEM_STACK_TRACE64 elemento esteso. Si noti che i consumer a 32 bit possono ricevere tracce dello stack a 64 bit da processi a 64 bit.
ControlFlags
Riservato. Impostare su 0.
SourceId
GUID che identifica in modo univoco il chiamante che abilita o disabilita il provider. Se il provider non implementa EnableCallback, il GUID non viene usato.
EnableFilterDesc
Struttura EVENT_FILTER_DESCRIPTOR che punta ai dati del filtro. Il provider usa i dati di filtro per impedire che gli eventi corrispondano ai criteri di filtro da scrivere nella sessione. Il provider determina il layout dei dati e come applica il filtro ai dati dell'evento. Una sessione può passare un solo filtro al provider.
Una sessione può chiamare la funzione TdhEnumerateProviderFilters per determinare i filtri schematizzati che può passare al provider.
Commenti
ENABLE_TRACE_PARAMETERS_V1 è obsoleto. La struttura ENABLE_TRACE_PARAMETERS è una struttura della versione 2 e sostituisce la struttura ENABLE_TRACE_PARAMETERS_V1 .
In genere, nei computer a 64 bit non è possibile acquisire lo stack del kernel in determinati contesti quando gli errori di pagina non sono consentiti. Per abilitare l'attivazione dello stack del kernel in x64, impostare il valore del DisablePagingExecutive Registro di sistema gestione memoria su 1. Il DisablePagingExecutive valore del Registro di sistema si trova nella chiave del Registro di sistema seguente: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management.
Questa operazione deve essere eseguita solo per scopi di diagnosi temporanei perché aumenta l'utilizzo della memoria del sistema.
Requisiti
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| Intestazione | evntrace.h |