OpenTraceFromRealTimeLoggerWithAllocationOptions-Funktion (evntrace.h)

Erstellt eine Ablaufverfolgungsverarbeitungssitzung, die einer aktiven ETW-Sitzung in Echtzeit angefügt ist.

Syntax

ETW_APP_DECLSPEC_DEPRECATED TRACEHANDLE 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 muss LogFileHeadernull sein, wenn LogFileHeader nicht NULL ist.

Sie können Ereignisse nur in Echtzeit nutzen, wenn der Ablaufverfolgungscontroller das LogFileMode-Element von EVENT_TRACE_PROPERTIES so festgelegt hat, dass er das EVENT_TRACE_REAL_TIME_MODE-Flag enthält.

Nur Benutzer mit Administratorrechten, Benutzer in der Gruppe Leistungsprotokollbenutzer und Anwendungen, die als LocalSystem, LocalService und NetworkService ausgeführt werden, können Ereignisse in Echtzeit nutzen. Um einem eingeschränkten Benutzer die Möglichkeit zu geben, Ereignisse in Echtzeit zu nutzen, fügen Sie sie der Gruppe Leistungsprotokollbenutzer hinzu, oder rufen Sie EventAccessControl auf.

Options

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

AllocationSize

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

MemoryPartitionHandle

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

LogFileHeader

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

Rückgabewert

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

Hinweise

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	evntrace.h
Bibliothek	Sechost.lib auf Windows 8.1 und Windows Server 2012 R2; Advapi32.lib unter Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista und Windows XP
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