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

Vedi anche

ENABLE_TRACE_PARAMETERS

EVENT_FILTER_DESCRIPTOR

EnableTraceEx2