EventSourceSettings 枚举
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
指定事件源的配置选项。
此枚举支持其成员值的按位组合。
public enum class EventSourceSettings
[System.Flags]
public enum EventSourceSettings
[<System.Flags>]
type EventSourceSettings =
Public Enum EventSourceSettings
- 继承
- 属性
字段
| 名称 | 值 | 说明 |
|---|---|---|
| Default | 0 | 未启用任何特殊配置选项。 |
| ThrowOnEventWriteErrors | 1 | 发生错误时,事件源将引发异常。 |
| EtwManifestEventFormat | 4 | 当引发事件时,ETW 侦听器应使用基于清单的格式。 定义派生自 EventSource 使用受保护 EventSource 构造函数之一的类型时,这是默认选项。 与此相比,此格式的按事件序列化开销较低 EtwSelfDescribingEventFormat。 有关详细信息,请参阅 自我描述与清单事件格式。 |
| EtwSelfDescribingEventFormat | 8 | ETW 侦听器应使用自描述事件格式。 这是使用公共EventSource构造函数之一创建新实例EventSource时的默认选项。 与不使用 TraceEvent 库的侦听器相比,此格式具有更多功能和更好的兼容性,但每个事件的序列化开销 EtwManifestEventFormat更高。 有关详细信息,请参阅 自我描述与清单事件格式。 |
注解
仅应指定 EtwManifestEventFormat 或 EtwSelfDescribingEventFormat,但不应同时指定这两者。