TraceSetInformation-Funktion (evntrace.h)

Die TraceSetInformation-Funktion konfiguriert Die Einstellungen der Ereignisablaufverfolgungssitzung.

Syntax

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

Parameter

TraceId

[in] InformationClass

Die zu aktivierende oder zu deaktivierende Informationsklasse. Die Von der -Klasse erfassten Informationen sind im Abschnitt "Erweiterte Daten" 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 informationenklassenspezifische Daten. 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, aber die Befehlslänge ist falsch. Dieser Fehler wird zurückgegeben, wenn der InformationLength-Parameter 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 Meldungszeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

Rufen Sie diese Funktion nach dem Aufrufen von StartTrace auf.

Wenn der Parameter InformationClass auf TraceStackTracingInfo festgelegt ist, wird durch Aufrufen dieser Funktion die Stapelablaufverfolgung der angegebenen Kernelereignisse aktiviert. Nachfolgende Aufrufe dieser Funktion überschreiben die vorherige Liste der Kernelereignisse, für die die Stapelablaufverfolgung aktiviert ist. Um die Stapelablaufverfolgung zu deaktivieren, rufen Sie diese Funktion auf, wobei InformationClass auf TraceStackTracingInfo und InformationLength auf 0 festgelegt ist.

Der Abschnitt für erweiterte Daten des Ereignisses enthält die Aufrufliste. Die StackWalk_Event MOF-Klasse definiert das Layout der erweiterten Daten.

In der Regel können Sie auf 64-Bit-Computern den Kernelstapel in bestimmten Kontexten nicht erfassen, wenn Seitenfehler nicht zulässig sind. Um das Durchlaufen 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 vorübergehende Diagnosezwecke erfolgen, da dadurch die Speicherauslastung des Systems erhöht wird.

Anforderungen

Weitere Informationen

TRACE_QUERY_INFO_CLASS

TraceQueryInformation