Event tracing sessions can be easily configured for managing the storage or delivery of events.
This enumeration describes the flags that can be used when setting-up the TraceLogMode property in the EventTraceSession class.
[Visual Basic]
Public Enum EventTraceLoggingModes
[C#]
public enum EventTraceLoggingModes
[C++]
__value public enum EventTraceLoggingModes
Members
| Member name |
Description |
| FileModeNone |
Not used.
The event tracing API flag for this is EVENT_TRACE_FILE_MODE_NONE. |
| FileModeSequential |
Write events to a log file sequentially. Stop when the file reaches the maximum size.
Do not use with FileModeCircular.
The event tracing API flag for this is EVENT_TRACE_FILE_MODE_SEQUENTIAL. |
| FileModeCircular |
Write events to a log file. When the file reaches the maximum size, the oldest events are replaced with newer events.
Do not use with RealTimeMode or FileModeSequential.
The event tracing API flag for this is EVENT_TRACE_FILE_MODE_CIRCULAR. |
FileModeAppend
(Windows XP only) |
Append new events to an existing sequential log file.
Do not use with RealTimeMode or
FileModeCircular.
The event tracing API flag for this is EVENT_TRACE_FILE_MODE_APPEND. |
FileModeNewFile
(Windows XP only) |
Automatically switches to a new log file when the file reaches the maximum size. The specified file name must be a formatted string (i.e. it must contain a %d). Each time a new file is created, a counter is incremented and its value is used. The formatted string is used as the file name.
Do not use with FileModeCircular.
The event tracing API flag for this is EVENT_TRACE_FILE_MODE_NEWFILE. |
| FileModePreAllocate |
When a session is created with StartTrace, the log file is extended to the MaximumFileSize. The file occupies the entire space during logging, for both circular and sequential log files. When the session is stopped, the log file is reduced to the size needed.
This flag is useful if there is concern about running out of disk space during the session.
The event tracing API flag for this is EVENT_TRACE_FILE_MODE_PREALLOCATE. |
| RealTimeMode |
Deliver the events to consumers in real time.
Do not use with FileModeCircular or FileModeSequential.
The event tracing API flag for this is EVENT_TRACE_REAL_TIME_MODE. |
| DelayOpenFileMode |
Delay opening file.
Do not specify this setting; it is used internally.
The event tracing API flag for this is EVENT_TRACE_DELAY_OPEN_FILE_MODE. |
| BufferingMode |
Events are not written to a log file or delivered in real-time.
Do not specify this setting; it is used internally.
The event tracing API flag for this is EVENT_TRACE_BUFFERING_MODE. |
| PrivateLoggerMode |
A private event tracing session is a user-mode event tracing session that runs in the same process as its event trace provider.
The event tracing API flag for this is EVENT_TRACE_PRIVATE_LOGGER_MODE. |
| AddHeaderMode |
Add a log file header.
Do not specify this setting; it is used internally.
The event tracing API flag for this is EVENT_TRACE_ADD_HEADER_MODE. |
UseGlobalSequence
(Windows XP only) |
Use sequence numbers that are unique across event tracing sessions. See TraceMessage for usage details.
The event tracing API flag for this is EVENT_TRACE_USE_GLOBAL_SEQUENCE. |
UseLocalSequence
(Windows XP only) |
Use sequence numbers that are unique only for an individual event tracing session. See TraceMessage for usage details.
The event tracing API flag for this is EVENT_TRACE_USE_LOCAL_SEQUENCE. |
RelogMode
(Windows XP only) |
Logs the event without including EVENT_TRACE_HEADER. The logger was started to relog one or more existing log files to a new log file.
Therefore, the variable portion of the relogged event already has a header from the old log file.
The event tracing API flag for this is EVENT_TRACE_RELOG_MODE. |
UsePagedMemory
(Windows XP only) |
Use paged memory. This setting is recommended so that events do not use up the nonpaged system memory.
The event tracing API flag for this is EVENT_TRACE_USE_PAGED_MEMORY. |
Requirements
Platforms: Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family
Assembly: WmiSolutions.EventTracing.dll
See Also
EventTraceException Members |
EventTraceException Class