You should not enable real-time mode if there are no consumers to consume the events because calls to log events will eventually fail when the buffers become full. Events are delivered when the buffers are flushed, not at the time the provider writes the event. This option is supported on Windows Vista and later.ĭelivers the events to consumers in real-time. Restricts who can log events to the session to those with TRACELOG_LOG_EVENT permission. This mode is only supported by Autologger.This option is supported on Windows Vista and later. You cannot use the mode for private event tracing sessions.ĮVENT_TRACE_NONSTOPPABLE_MODE(0x00000040) You must set EVENT_TRACE_PROPERTIES.MaximumFileSize. When you stop the session, the log file is reduced to the size needed. The file occupies the entire space during logging, for both circular and sequential log files. Reserves EVENT_TRACE_PROPERTIES.MaximumFileSize bytes of disk space for the log file in advance. This option is not allowed for private event tracing sessions and should not be used for NT kernel logger sessions.ĭo not use with EVENT_TRACE_FILE_MODE_CIRCULAR, EVENT_TRACE_FILE_MODE_APPEND or EVENT_TRACE_FILE_MODE_SEQUENTIAL.ĮVENT_TRACE_FILE_MODE_PREALLOCATE(0x00000020) Each time a new file is created, a counter is incremented and its value is used, the formatted string is updated, and the resulting string is used as the file name. The MaximumFileSize member of EVENT_TRACE_PROPERTIES must be set.The specified file name must be a formatted string (for example, the string contains a %d, such as c: est%d.etl). Windows 2000: This value is not supported.ĮVENT_TRACE_FILE_MODE_NEWFILE (0x00000008)Īutomatically switches to a new log file when the file reaches the maximum size. When using EVENT_TRACE_FILE_MODE_APPEND, the values for BufferSize, NumberOfProcessors, and ClockType must be explicitly provided and must be the same in both the logger and the file being appended.ĭo not use with EVENT_TRACE_REAL_TIME_MODE, EVENT_TRACE_FILE_MODE_CIRCULAR, EVENT_TRACE_FILE_MODE_NEWFILE, or EVENT_TRACE_PRIVATE_LOGGER_MODE. Use only if you specify system time for the clock resolution, otherwise, ProcessTrace will return events with incorrect time stamps. If the file does not exist, it is created. After the file reaches the maximum size, the oldest events are replaced with incoming events.Note that the contents of the circular log file may appear out of order on multiprocessor computers.ĭo not use with EVENT_TRACE_FILE_MODE_APPEND, EVENT_TRACE_FILE_MODE_NEWFILE, or EVENT_TRACE_FILE_MODE_SEQUENTIAL.ĮVENT_TRACE_FILE_MODE_APPEND (0x00000004)Īppends events to an existing sequential log file. Writes events to a log file sequentially stops when the file reaches its maximum size.Do not use with EVENT_TRACE_FILE_MODE_CIRCULAR or EVENT_TRACE_FILE_MODE_NEWFILE.ĮVENT_TRACE_FILE_MODE_CIRCULAR (0x00000002) Same as EVENT_TRACE_FILE_MODE_SEQUENTIAL with no maximum file size specified.ĮVENT_TRACE_FILE_MODE_SEQUENTIAL (0x00000001) These constants are defined in the Evntrace.h header file. The constants are used in the LogFileMode members of EVENT_TRACE_LOGFILE, EVENT_TRACE_PROPERTIES and TRACE_LOGFILE_HEADER structures. The following constants represent the possible logging modes for an event tracing session.

Autologger for daoc