TraceSetInformation-Funktion (evntrace.h)

Die TraceSetInformation-Funktion konfiguriert sitzungseinstellungen für die Ereignisablaufverfolgung.

Syntax

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

Die Parameter

TraceId

[in] InformationClass

Die Informationsklasse, die aktiviert oder deaktiviert werden soll. Die Informationen, die die Klasse erfasst, sind im Erweiterten Datenabschnitt des Ereignisses enthalten. Eine Liste der Informationsklassen, die Sie aktivieren können, finden Sie in der TRACE_QUERY_INFO_CLASS Enumeration.

[in] TraceInformation

Ein Zeiger auf spezifische Daten der Informationsklasse. Die Informationsklasse bestimmt den Inhalt dieses Parameters.

[in] InformationLength

Die Größe der Daten im TraceInformation-Puffer in Bytes.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

• ERROR_BAD_LENGTH

  Das Programm hat einen Befehl ausgegeben, die Befehlslänge ist jedoch falsch. Dieser Fehler wird zurückgegeben, wenn der Parameter InformationLength kleiner als eine Mindestgröße ist.

• ERROR_INVALID_PARAMETER

  Der Parameter ist falsch.

• ERROR_NOT_SUPPORTED

  Die Anforderung wird nicht unterstützt.

• Andere

  Verwenden Sie FormatMessage , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Bemerkungen

Rufen Sie diese Funktion nach dem Aufrufen von StartTrace auf.

Wenn der Parameter InformationClass auf TraceStackTracingInfo festgelegt ist, ermöglicht das Aufrufen dieser Funktion die Stapelablaufverfolgung der angegebenen Kernelereignisse. Nachfolgende Aufrufe dieser Funktion überschreiben die vorherige Liste der Kernelereignisse, für die die Stapelablaufverfolgung aktiviert ist. Rufen Sie diese Funktion auf, um die Stapelablaufverfolgung zu deaktivieren, wobei "InformationClass " auf "TraceStackTracingInfo " und "InformationLength " auf "0" festgelegt ist.

Der erweiterte Datenabschnitt des Ereignisses enthält den Aufrufstapel. Die StackWalk_Event MOF-Klasse definiert das Layout der erweiterten Daten.

Normalerweise können Sie auf 64-Bit-Computern den Kernelstapel nicht in bestimmten Kontexten erfassen, wenn Seitenfehler nicht zulässig sind. Um das Laufen des Kernelstapels auf x64 zu aktivieren, legen Sie den Registrierungswert für die DisablePagingExecutive Speicherverwaltung auf 1 fest. Der DisablePagingExecutive Registrierungswert befindet sich unter dem folgenden Registrierungsschlüssel: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management. Dies sollte nur für temporäre Diagnosezwecke erfolgen, da dadurch die Arbeitsspeicherauslastung des Systems erhöht wird.

Anforderungen

Siehe auch

TRACE_QUERY_INFO_CLASS

TraceQueryInformation