evntrace.h-Header

Dieser Header wird von mehreren Technologien verwendet. Weitere Informationen finden Sie unter

• Ereignisablaufverfolgung
• Kernelmodustreiberreferenz

evntrace.h enthält die folgenden Programmierschnittstellen:

Functions

CloseTrace Die CloseTrace-Funktion schließt eine Ablaufverfolgungsverarbeitungssitzung, die mit OpenTrace erstellt wurde.
ControlTraceA Die ControlTraceA(ANSI)-Funktion (evntrace.h) leeren, abfragen, aktualisieren oder beenden die angegebene Ereignisablaufverfolgungssitzung.
ControlTraceW Die ControlTraceW-Funktion (Unicode) (evntrace.h) leert, fragt, aktualisiert oder beendet die angegebene Ereignisablaufverfolgungssitzung.
CreateTraceInstanceId Ein RegisterTraceGuids-basierter ("Classic")-Ereignisanbieter verwendet die CreateTraceInstanceId-Funktion, um einen eindeutigen Transaktionsbezeichner zu erstellen und einem Registrierungshandle zuzuordnen. Der Anbieter kann dann den Transaktionsbezeichner verwenden, wenn er die TraceEventInstance-Funktion aufruft.
EnableTrace Ein Ablaufverfolgungssitzungscontroller ruft EnableTrace auf, um zu konfigurieren, wie ein ETW-Ereignisanbieter Ereignisse in einer Ablaufverfolgungssitzung protokolliert. Die EnableTraceEx2-Funktion ersetzt diese Funktion.
EnableTraceEx Ein Ablaufverfolgungssitzungscontroller ruft EnableTraceEx auf, um zu konfigurieren, wie ein ETW-Ereignisanbieter Ereignisse in einer Ablaufverfolgungssitzung protokolliert. Die EnableTraceEx2-Funktion ersetzt diese Funktion.
EnableTraceEx2 Ein Ablaufverfolgungssitzungscontroller ruft EnableTraceEx2 auf, um zu konfigurieren, wie ein ETW-Ereignisanbieter Ereignisse in einer Ablaufverfolgungssitzung protokolliert.
EnumerateTraceGuids Ruft Informationen zu Ereignisablaufverfolgungsanbietern ab, die derzeit auf dem Computer ausgeführt werden. Die EnumerateTraceGuidsEx-Funktion ersetzt diese Funktion.
EnumerateTraceGuidsEx Ruft Informationen zu Ereignisablaufverfolgungsanbietern ab, die derzeit auf dem Computer ausgeführt werden.
FlushTraceA Die FlushTraceA(ANSI)-Funktion (evntrace.h) bewirkt, dass eine Ereignisablaufverfolgungssitzung sofort gepufferte Ereignisse für die angegebene Sitzung übermittelt.
FlushTraceW Die FlushTraceW-Funktion (Unicode) (evntrace.h) bewirkt, dass eine Ereignisablaufverfolgungssitzung sofort gepufferte Ereignisse für die angegebene Sitzung übermittelt.
GetTraceEnableFlags Ein RegisterTraceGuids-basierter Ereignisanbieter ("Classic") verwendet die GetTraceEnableFlags-Funktion, um die vom Ablaufverfolgungscontroller angegebenen Aktivierungsflags abzurufen, um anzugeben, welche Kategorie von Ereignissen nachverfolgt werden soll. Anbieter rufen diese Funktion über ihre ControlCallback-Funktion auf.
GetTraceEnableLevel Ein RegisterTraceGuids-basierter ("Classic")-Ereignisanbieter verwendet die GetTraceEnableLevel-Funktion, um die vom Ablaufverfolgungscontroller angegebene Aktivierungsebene abzurufen, um anzugeben, welche Ereignisebene nachverfolgt werden soll. Anbieter rufen diese Funktion über ihre ControlCallback-Funktion auf.
GetTraceLoggerHandle Ein RegisterTraceGuids-basierter Ereignisanbieter ("Classic") verwendet die GetTraceLoggerHandle-Funktion, um das Handle der Ereignisablaufverfolgungssitzung abzurufen, in die Ereignisse geschrieben werden sollen. Anbieter rufen diese Funktion über ihre ControlCallback-Funktion auf.
OpenTraceA Die Funktion OpenTraceA (ANSI) (evntrace.h) öffnet ein ETW-Ablaufverfolgungsverarbeitungshandle für die Nutzung von Ereignissen aus einer ETW-Echtzeitablaufverfolgungssitzung oder einer ETW-Protokolldatei.
OpenTraceFromBufferStream Erstellt eine Ablaufverfolgungsverarbeitungssitzung, die nicht direkt an eine Datei oder aktive Sitzung angefügt ist.
OpenTraceFromFile Erstellt eine Ablaufverfolgungsverarbeitungssitzung, um eine Tracelog-ETL-Datei zu verarbeiten.
OpenTraceFromRealTimeLogger Öffnet ein ETW-Ablaufverfolgungsverarbeitungshandle für die Nutzung von Ereignissen aus einer ETW-Echtzeitablaufverfolgungssitzung oder einer ETW-Protokolldatei.
OpenTraceFromRealTimeLoggerWithAllocationOptions Erstellt eine Ablaufverfolgungsverarbeitungssitzung, die an eine aktive ETW-Sitzung in Echtzeit angefügt ist.
OpenTraceW Die OpenTraceW-Funktion (Unicode) (evntrace.h) öffnet ein ETW-Ablaufverfolgungsverarbeitungshandle zum Nutzen von Ereignissen aus einer ETW-Echtzeitablaufverfolgungssitzung oder einer ETW-Protokolldatei.
ProcessTrace Übermittelt Ereignisse aus einer oder mehreren Ablaufverfolgungsverarbeitungssitzungen an den Consumer.
ProcessTraceAddBufferToBufferStream Stellt einen ETW-Ablaufverfolgungspuffer für eine Von OpenTraceFromBufferStream erstellte Verarbeitungssitzung bereit.
ProcessTraceBufferDecrementReference Gibt einen Verweis auf einen Puffer frei, der von ProcessTraceBufferIncrementReference hinzugefügt wurde.
ProcessTraceBufferIncrementReference Wird während des BufferCallback für den bereitgestellten Puffer aufgerufen, um zu verhindern, dass es freigegeben wird, bis der Aufrufer damit fertig ist.
QueryAllTracesA Die Funktion QueryAllTracesA (ANSI) (evntrace.h) ruft die Eigenschaften und Statistiken für alle Ereignisablaufverfolgungssitzungen ab, die der Aufrufer abfragen kann.
QueryAllTracesW Die Funktion QueryAllTracesW (Unicode) (evntrace.h) ruft die Eigenschaften und Statistiken für alle Ereignisablaufverfolgungssitzungen ab, die der Aufrufer abfragen kann.
QueryTraceA Die QueryTraceA(ANSI)-Funktion (evntrace.h) ruft die Eigenschafteneinstellungen und Sitzungsstatistiken für die angegebene Ereignisablaufverfolgungssitzung ab.
QueryTraceProcessingHandle Ruft Informationen zu einer ETW-Ablaufverfolgungsverarbeitungssitzung ab, die von OpenTrace geöffnet wird.
QueryTraceW Die QueryTraceW-Funktion (Unicode) (evntrace.h) ruft die Eigenschafteneinstellungen und Sitzungsstatistiken für die angegebene Ereignisablaufverfolgungssitzung ab.
RegisterTraceGuidsA Die RegisterTraceGuidsA(ANSI)-Funktion (evntrace.h) ist eine veraltete Funktion, und neuer Code sollte die bereitgestellte Alternative verwenden.
RegisterTraceGuidsW Die RegisterTraceGuidsW (Unicode)-Funktion (evntrace.h) ist eine veraltete Funktion, und neuer Code sollte die bereitgestellte Alternative verwenden.
RemoveTraceCallback Die RemoveTraceCallback-Funktion verhindert, dass eine EventCallback-Funktion Ereignisse für eine Ereignisablaufverfolgungsklasse empfängt. Diese Funktion ist veraltet.
SetTraceCallback Die SetTraceCallback-Funktion gibt eine EventCallback-Funktion zum Verarbeiten von Ereignissen für die angegebene Ereignisablaufverfolgungsklasse an. Diese Funktion ist veraltet.
StartTraceA Die StartTrace-Funktion startet eine Ereignisablaufverfolgungssitzung. (ANSI)
StartTraceW Die StartTrace-Funktion startet eine Ereignisablaufverfolgungssitzung. (Unicode)
StopTraceA Die StopTraceA-Funktion (ANSI) (evntrace.h) beendet die angegebene Ereignisablaufverfolgungssitzung. Die ControlTrace-Funktion ersetzt diese Funktion.
StopTraceW Die StopTraceW-Funktion (Unicode) (evntrace.h) beendet die angegebene Ereignisablaufverfolgungssitzung. Die ControlTrace-Funktion ersetzt diese Funktion.
Traceevent Ein RegisterTraceGuids-basierter ("Classic")-Ereignisanbieter verwendet die TraceEvent-Funktion, um ein strukturiertes Ereignis an eine Ereignisablaufverfolgungssitzung zu senden.
TraceEventInstance Ein RegisterTraceGuids-basierter ("Classic")-Ereignisanbieter verwendet die TraceEventInstance-Funktion, um ein strukturiertes Ereignis an eine Ereignisablaufverfolgungssitzung mit einem instance Bezeichner zu senden.
TraceMessage Ein RegisterTraceGuids-basierter ("Classic")-Ereignisanbieter verwendet die TraceMessage-Funktion, um ein nachrichtenbasiertes (TMF-basiertes WPP)-Ereignis an eine Ereignisablaufverfolgungssitzung zu senden.
TraceMessageVa Ein RegisterTraceGuids-basierter Ereignisanbieter ("Classic") verwendet die TraceMessageVa-Funktion, um ein nachrichtenbasiertes (TMF-basiertes WPP)-Ereignis mithilfe von va_list Parametern an eine Ereignisablaufverfolgungssitzung zu senden.
TraceQueryInformation Stellt Informationen zu einer Ereignisablaufverfolgungssitzung bereit.
TraceSetInformation Konfiguriert Die Einstellungen der Ereignisablaufverfolgungssitzung.
UnregisterTraceGuids Hebt die Registrierung eines ETW-Ereignisablaufverfolgungsanbieters im Stil "Classic" (Windows 2000) auf, der mit RegisterTraceGuids registriert wurde.
UpdateTraceA Die UpdateTraceA(ANSI)-Funktion (evntrace.h) aktualisiert die Eigenschafteneinstellung der angegebenen Ereignisablaufverfolgungssitzung.
UpdateTraceW Die UpdateTraceW-Funktion (Unicode) (evntrace.h) aktualisiert die -Eigenschaftseinstellung der angegebenen Ereignisablaufverfolgungssitzung.

Rückruffunktionen

PETW_BUFFER_CALLBACK Funktionsdefinition für das BufferCallback, das von ProcessTrace aufgerufen wird.
PETW_BUFFER_COMPLETION_CALLBACK Funktionsdefinition für den Rückruf, der ausgelöst wird, wenn ProcessTraceAddBufferToBufferStream mit einem Puffer abgeschlossen wird. Dieser Rückruf sollte in der Regel den Puffer nach Bedarf freigeben.
PEVENT_CALLBACK ETW-Ereignisconsumer implementieren diesen Rückruf, um Ereignisse von einer Ablaufverfolgungsverarbeitungssitzung zu empfangen. Der EventRecordCallback-Rückruf ersetzt diesen Rückruf.
PEVENT_RECORD_CALLBACK ETW-Ereignisconsumer implementieren diesen Rückruf, um Ereignisse von einer Ablaufverfolgungsverarbeitungssitzung zu empfangen. Der PEVENT_RECORD_CALLBACK Typ definiert einen Zeiger auf diese Rückruffunktion. EventRecordCallback ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.
PEVENT_TRACE_BUFFER_CALLBACKA Die funktion PEVENT_TRACE_BUFFER_CALLBACKA (ANSI) (evntrace.h) ruft Statistiken zu jedem Ereignispuffer ab, den ETW während einer Ablaufverfolgungsverarbeitungssitzung sendet.
PEVENT_TRACE_BUFFER_CALLBACKW Die funktion PEVENT_TRACE_BUFFER_CALLBACKW (Unicode) (evntrace.h) ruft Statistiken zu jedem Ereignispuffer ab, den ETW während einer Ablaufverfolgungsverarbeitungssitzung sendet.
WMIDPREQUEST Ein RegisterTraceGuids-basierter ("Classic")-Ereignisanbieter implementiert diese Funktion, um Benachrichtigungen von Controllern zu empfangen. Der WMIDPREQUEST-Typ definiert einen Zeiger auf diese Rückruffunktion. ControlCallback ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Strukturen

CLASSIC_EVENT_ID Gibt das Kernelereignis an, für das Sie die Aufrufstapelablaufverfolgung aktivieren möchten.
ENABLE_TRACE_PARAMETERS Enthält Informationen, die zum Aktivieren eines Anbieters über EnableTraceEx2 verwendet werden.
ENABLE_TRACE_PARAMETERS_V1 Enthält Informationen, die zum Aktivieren eines Anbieters über EnableTraceEx2 verwendet werden. Diese Struktur ist veraltet.
ETW_BUFFER_CALLBACK_INFORMATION Wird für bufferCallback als ConsumerInfo-Parameter bereitgestellt und stellt Details zur aktuellen Verarbeitungssitzung bereit.
ETW_BUFFER_CONTEXT Stellt Kontextinformationen zum Ereignis bereit.
ETW_BUFFER_HEADER Die Headerstruktur eines ETW-Puffers.
ETW_OPEN_TRACE_OPTIONS Stellt Konfigurationsparameter für die Funktionen OpenTraceFromBufferStream, OpenTraceFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions bereit.
ETW_TRACE_PARTITION_INFORMATION Enthält Partitionsinformationen, die aus einer ETW-Ablaufverfolgung abgerufen werden.
EVENT_INSTANCE_HEADER Die EVENT_INSTANCE_HEADER-Struktur enthält Standardinformationen zur Ereignisablaufverfolgung, die allen von TraceEventInstance geschriebenen Ereignissen gemeinsam sind.
EVENT_INSTANCE_INFO Die EVENT_INSTANCE_INFO-Struktur ordnet einen eindeutigen Transaktionsbezeichner einer registrierten Ereignisablaufverfolgungsklasse für TraceEventInstance zu.
EVENT_TRACE Die EVENT_TRACE-Struktur wird verwendet, um Ereignisinformationen an einen Ereignisablaufverfolgungsconsumer zu übermitteln.
EVENT_TRACE_HEADER Die EVENT_TRACE_HEADER-Struktur enthält Standardinformationen zur Ereignisablaufverfolgung, die allen von TraceEvent geschriebenen Ereignissen gemeinsam sind.
EVENT_TRACE_LOGFILEA Die EVENT_TRACE_LOGFILEA-Struktur (ANSI) (evntrace.h) speichert Informationen zu einer Ablaufverfolgungsdatenquelle.
EVENT_TRACE_LOGFILEW Die EVENT_TRACE_LOGFILEW (Unicode)-Struktur (evntrace.h) speichert Informationen zu einer Ablaufverfolgungsdatenquelle.
EVENT_TRACE_PROPERTIES Die EVENT_TRACE_PROPERTIES-Struktur enthält Informationen zu einer Ereignisablaufverfolgungssitzung und wird mit APIs wie StartTrace und ControlTrace verwendet.
EVENT_TRACE_PROPERTIES_V2 Die EVENT_TRACE_PROPERTIES_V2-Struktur enthält Informationen zu einer Ereignisablaufverfolgungssitzung und wird mit APIs wie StartTrace und ControlTrace verwendet.
MOF_FIELD Sie können die MOF_FIELD-Strukturen verwenden, um Ereignisdaten an die EVENT_TRACE_HEADER- oder EVENT_INSTANCE_HEADER-Strukturen anzufügen.
TRACE_ENABLE_INFO Definiert die Sitzung und die Informationen, die die Sitzung zum Aktivieren des Anbieters verwendet hat.
TRACE_GUID_INFO Wird von EnumerateTraceGuidsEx zurückgegeben. Definiert den Header für die Liste der Sitzungen, die einen Anbieter aktiviert haben.
TRACE_GUID_PROPERTIES Wird von EnumerateTraceGuids zurückgegeben. Enthält Informationen zu einem Ereignisablaufverfolgungsanbieter.
TRACE_GUID_REGISTRATION Wird mit RegisterTraceGuids verwendet, um Ereignisablaufverfolgungsklassen zu registrieren.
TRACE_LOGFILE_HEADER Die TRACE_LOGFILE_HEADER-Struktur enthält Informationen zu einer Ereignisablaufverfolgungssitzung und deren Ereignissen.
TRACE_PERIODIC_CAPTURE_STATE_INFO Wird mit TraceQueryInformation und TraceSetInformation verwendet, um Informationen im Zusammenhang mit einem regelmäßigen Erfassungszustand abzurufen oder festzulegen.
TRACE_PROVIDER_INSTANCE_INFO Definiert eine instance der Anbieter-GUID.
TRACE_VERSION_INFO Bestimmt die Versionsinformationen der TraceLogging-Sitzung.

Enumerationen

ETW_PROCESS_HANDLE_INFO_TYPE Gibt den Vorgang an, der für eine Ablaufverfolgungsverarbeitungssitzung ausgeführt wird.
ETW_PROCESS_TRACE_MODES Gibt die unterstützten Prozessablaufverfolgungsmodi an.
TRACE_QUERY_INFO_CLASS Wird mit EnumerateTraceGuidsEx und TraceSetInformation verwendet, um einen Typ von Ablaufverfolgungsinformationen anzugeben.