OpenTraceFromRealTimeLoggerWithAllocationOptions-Funktion (evntrace.h)

Artikel
07/19/2024

Erstellt eine Ablaufverfolgungsverarbeitungssitzung, die an eine aktive ECHTZEIT-ETW-Sitzung angefügt ist.

Syntax

ETW_APP_DECLSPEC_DEPRECATED PROCESSTRACE_HANDLE WMIAPI OpenTraceFromRealTimeLoggerWithAllocationOptions(
  PCWSTR                       LoggerName,
  const ETW_OPEN_TRACE_OPTIONS *Options,
  ULONG_PTR                    AllocationSize,
  HANDLE                       MemoryPartitionHandle,
  TRACE_LOGFILE_HEADER         *LogFileHeader
);

Parameter

LoggerName

Name der Echtzeitereignisablaufverfolgungssitzung oder NULL-, wenn Daten aus einer Protokolldatei verarbeitet werden. Geben Sie einen Wert für dieses Element an, wenn Sie OpenTraceFromRealTimeLoggerWithAllocationOptions- aufrufen, um Daten aus einer Echtzeitsitzung zu nutzen.

Beim Aufrufen von OpenTraceFromRealTimeLoggerWithAllocationOptions, wenn LogFileHeader nichtNULL- ist, muss LoggerName-NULL-sein.

Sie können Ereignisse nur in Echtzeit verwenden, wenn der Ablaufverfolgungscontroller das LogFileMode- Mitglied von EVENT_TRACE_PROPERTIES so festgelegt hat, dass das EVENT_TRACE_REAL_TIME_MODE Flag eingeschlossen wird.

Nur Benutzer mit Administratorrechten, Benutzer in der Gruppe "Performance Log Users" und Anwendungen, die als LocalSystem, LocalService, NetworkService ausgeführt werden, können Ereignisse in Echtzeit nutzen. Um einem eingeschränkten Benutzer die Möglichkeit zu gewähren, Ereignisse in Echtzeit zu nutzen, fügen Sie sie der Gruppe "Performance Log Users" hinzu, oder rufen Sie EventAccessControlauf.

Options

Konfigurationsoptionen für diese Verarbeitungssitzung. Weitere Informationen finden Sie unter ETW_OPEN_TRACE_OPTIONS.

AllocationSize

Die Größe des Speichers in Bytes, der vor dem Speichern von ETW-Puffern während der Verarbeitung zugewiesen wird. Eine größere Zuweisung reduziert den Bedarf an individuellen Zuordnungen/kostenlosen Anrufen zu Kosten einer höheren konsistenten Speicherauslastung. Dies wird auf ein Minimum des gesamten Pufferraums der zugrunde liegenden Real-Time ETW-Sitzung nach oben angepasst, um sicherzustellen, dass genügend für die grundlegende Funktion zugeordnet ist. Bei 0 wird die Standardgröße verwendet.

MemoryPartitionHandle

Das Handle für die Speicherpartition, die für Speicherzuweisungen für diese Verarbeitungssitzung verwendet werden soll. Wenn NULL, wird die Speicherpartition des Prozesses verwendet. Weitere Informationen finden Sie unter MemExtendedParameterPartitionHandle.

LogFileHeader

Kopfzeileninformationen für die Protokolldatei. Weitere Informationen finden Sie unter TRACE_LOGFILE_HEADER.

Rückgabewert

Eine TRACEHANDLE, die verwendet wird, um diese Verarbeitungssitzung zu identifizieren. Wird in der Regel an ProcessTrace- übergeben, um mit der Verarbeitung zu beginnen und CloseTrace- an die Verarbeitung zu beenden.

Bemerkungen

Sobald ProcessTrace für die zurückgegebene TRACEHANDLE-aufgerufen wird, empfängt dies Puffer aus der ETW-Sitzung, während sie geleert werden, und beginnen sofort mit der Verarbeitung und dem Aufrufen der in den Optionen angegebenen Rückrufe. Dies ist identisch mit OpenTraceFromRealTime, mit der Ausnahme, dass sie die Anpassung von Speicherzuordnungen für die Verarbeitungssitzung ermöglicht.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 11 2022 Update
mindestens unterstützte Server-	Windows Server 2022
Zielplattform-	Fenster
Header-	evntrace.h
Library	Advapi32.dll
DLL-	Sechost.dll unter Windows 8.1 und Windows Server 2012 R2; Advapi32.dll unter Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista und Windows XP

Freigeben über