evntrace.h-Header
Dieser Header wird von mehreren Technologien verwendet. Weitere Informationen finden Sie unter
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) löscht, fragt, aktualisiert oder beendet die angegebene Ereignisablaufverfolgungssitzung. |
| ControlTraceW Die ControlTraceW -Funktion (Unicode) (evntrace.h) löscht, fragt, aktualisiert oder beendet die angegebene Ereignisablaufverfolgungssitzung. |
| CreateTraceInstanceId Ein RegisterTraceGuids-basierter Ereignisanbieter ("Classic") verwendet die CreateTraceInstanceId-Funktion, um einen eindeutigen Transaktionsbezeichner zu erstellen und ihn einem Registrierungshandle zuzuordnen. Der Anbieter kann dann den Transaktionsbezeichner verwenden, wenn die Funktion TraceEventInstance aufgerufen wird. |
| EnableTrace Ein Ablaufverfolgungssitzungscontroller ruft EnableTrace auf, um zu konfigurieren, wie ein ETW-Ereignisanbieter Ereignisse in einer Ablaufverfolgungssitzung protokolliert. Die Funktion EnableTraceEx2 ersetzt diese Funktion. |
| EnableTraceEx Ein Ablaufverfolgungssitzungscontroller ruft EnableTraceEx auf, um zu konfigurieren, wie ein ETW-Ereignisanbieter Ereignisse in einer Ablaufverfolgungssitzung protokolliert. Die Funktion EnableTraceEx2 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 Funktion EnumerateTraceGuidsEx 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 liefert. |
| 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 Ereignisanbieter ("Classic") verwendet die GetTraceEnableLevel-Funktion, um die vom Ablaufverfolgungscontroller angegebene Aktivierungsebene abzurufen, um anzugeben, welche Ebene von Ereignissen 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 er Ereignisse schreiben soll. Anbieter rufen diese Funktion über ihre ControlCallback-Funktion auf. |
| OpenTraceA Die OpenTraceA (ANSI)-Funktion (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 zum Verbrauch von Ereignissen aus einer ETW-Echtzeitablaufverfolgungssitzung oder einer ETW-Protokolldatei. |
| OpenTraceFromRealTimeLoggerWithAllocationOptions Erstellt eine Ablaufverfolgungsverarbeitungssitzung, die einer aktiven 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 verarbeitungssitzung bereit, die von OpenTraceFromBufferStream erstellt wurde. |
| ProcessTraceBufferDecrementReference Gibt einen Verweis auf einen Puffer frei, der von ProcessTraceBufferIncrementReference hinzugefügt wurde. |
| ProcessTraceBufferIncrementReference Wird während des BufferCallbacks auf dem 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 wurde. |
| QueryTraceW Die QueryTraceW-Funktion (Unicode) (evntrace.h) ruft die Eigenschafteneinstellungen und Sitzungsstatistiken für die angegebene Ereignisablaufverfolgungssitzung ab. |
| RegisterTraceGuidsA Die RegisterTraceGuidsA -Funktion (ANSI) (evntrace.h) ist eine veraltete Funktion, und neuer Code sollte die bereitgestellte Alternative verwenden. |
| RegisterTraceGuidsW Die Funktion RegisterTraceGuidsW (Unicode) (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 an, um Ereignisse für die angegebene Ereignisablaufverfolgungsklasse zu verarbeiten. 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 Ereignisanbieter ("Classic") verwendet die TraceEvent-Funktion, um ein strukturiertes Ereignis an eine Ereignisablaufverfolgungssitzung zu senden. |
| TraceEventInstance Ein RegisterTraceGuids-basierter Ereignisanbieter ("Classic") verwendet die TraceEventInstance-Funktion, um ein strukturiertes Ereignis mit einem Instanzbezeichner an eine Ereignisablaufverfolgungssitzung zu senden. |
| TraceMessage Ein RegisterTraceGuids-basierter Ereignisanbieter ("Classic") 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 va_list Parameter an eine Ereignisablaufverfolgungssitzung zu senden. |
| TraceQueryInformation Stellt Informationen zu einer Ereignisablaufverfolgungssitzung bereit. |
| TraceSetInformation Konfiguriert Sitzungseinstellungen für die Ereignisablaufverfolgung. |
| Aufheben der RegistrierungTraceGuids Hebt die Registrierung eines ETW-Ereignisablaufverfolgungsanbieters "Klassisch" (Windows 2000-Format) auf, der mit RegisterTraceGuids registriert wurde. |
| UpdateTraceA Die UpdateTraceA-Funktion (ANSI) (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 den BufferCallback, der von ProcessTrace aufgerufen wird. |
| PETW_BUFFER_COMPLETION_CALLBACK Funktionsdefinition für den Rückruf, der ausgelöst wird, wenn ProcessTraceAddBufferToBufferStream mit einem Puffer abgeschlossen ist. Dieser Rückruf sollte in der Regel den Puffer nach Bedarf freigeben. |
| PEVENT_CALLBACK ETW-Ereignisverbraucher implementieren diesen Rückruf, um Ereignisse aus einer Ablaufverfolgungsverarbeitungssitzung zu empfangen. Der EventRecordCallback-Rückruf ersetzt diesen Rückruf. |
| PEVENT_RECORD_CALLBACK ETW-Ereignisverbraucher implementieren diesen Rückruf, um Ereignisse aus 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 Puffer von Ereignissen ab, die ETW während einer Ablaufverfolgungsverarbeitungssitzung sendet. |
| PEVENT_TRACE_BUFFER_CALLBACKW Die funktion PEVENT_TRACE_BUFFER_CALLBACKW (Unicode) (evntrace.h) ruft Statistiken zu jedem Puffer von Ereignissen ab, die ETW während einer Ablaufverfolgungsverarbeitungssitzung sendet. |
| WMIDPREQUEST Ein RegisterTraceGuids-basierter Ereignisanbieter ("Classic") 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 dem 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 Standardmäßige Ereignisablaufverfolgungsinformationen, 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 Ereignisablaufverfolgungs-Consumer 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_CONTEXT_REGISTER_INFO Gibt den Satz von Registern an, die beim Aktivieren der Kontextregisterablaufverfolgung protokolliert werden sollen. |
| 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 ihren Ereignissen. |
| TRACE_PERIODIC_CAPTURE_STATE_INFO Wird mit TraceQueryInformation und TraceSetInformation verwendet, um Informationen zu einem regelmäßigen Erfassungszustand abzurufen oder festzulegen. |
| TRACE_PROVIDER_INSTANCE_INFO Definiert eine Instanz der Anbieter-GUID. |
| TRACE_VERSION_INFO Bestimmt die Versionsinformationen der TraceLogging-Sitzung. |
Enumerationen
| ETW_CONTEXT_REGISTER_TYPES Gibt den Satz von Registern an, die erfasst werden sollen, wenn die Kontextregisterablaufverfolgung aktiviert ist. |
| 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. |