Funzione TraceSetInformation (evntrace.h)

La funzione TraceSetInformation configura le impostazioni della sessione di traccia eventi.

Sintassi

ULONG WMIAPI TraceSetInformation(
       CONTROLTRACE_ID  TraceId,
  [in] TRACE_INFO_CLASS InformationClass,
  [in] PVOID            TraceInformation,
  [in] ULONG            InformationLength
);

Parametri

TraceId

[in] InformationClass

Classe di informazioni da abilitare o disabilitare. Le informazioni acquisite dalla classe sono incluse nella sezione dei dati estesi dell'evento. Per un elenco delle classi di informazioni che è possibile abilitare, vedere l'enumerazione TRACE_QUERY_INFO_CLASS .

[in] TraceInformation

Puntatore a dati specifici della classe di informazioni. La classe di informazioni determina il contenuto di questo parametro.

[in] InformationLength

Dimensioni, in byte, dei dati nel buffer TraceInformation .

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

• ERROR_BAD_LENGTH

  Il programma ha emesso un comando, ma la lunghezza del comando non è corretta. Questo errore viene restituito se il parametro InformationLength è minore di una dimensione minima.

• ERROR_INVALID_PARAMETER

  Parametro non corretto.

• ERROR_NOT_SUPPORTED

  La richiesta non è supportata.

• Altri

  Usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito.

Commenti

Chiamare questa funzione dopo aver chiamato StartTrace.

Se il parametro InformationClass è impostato su TraceStackTracingInfo, la chiamata a questa funzione abilita la traccia dello stack degli eventi del kernel specificati. Le chiamate successive a questa funzione sovrascrivono l'elenco precedente di eventi del kernel per cui è abilitata la traccia dello stack. Per disabilitare la traccia dello stack, chiamare questa funzione con InformationClass impostato su TraceStackTracingInfo e InformationLength impostato su 0.

La sezione dei dati estesi dell'evento includerà lo stack di chiamate. La classe STACKWALK_EVENT MOF definisce il layout dei dati estesi.

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'esplorazione dello stack del kernel in x64, impostare il valore del DisablePagingExecutive Registro di sistema di gestione della memoria su 1. Il DisablePagingExecutive valore del Registro di sistema si trova nella seguente chiave del Registro di sistema: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management. Questa operazione deve essere eseguita solo a scopo di diagnosi temporanea perché aumenta l'utilizzo della memoria del sistema.

Requisiti

Vedi anche

TRACE_QUERY_INFO_CLASS

TraceQueryInformation