设置消息编译器 (MC.exe) 工具的属性。 编译器将生成消息资源文件,你可以将其添加到项目中。
例如,如果你使用 Windows 事件跟踪 (ETW) 内核模式 API 来为内核模式驱动程序添加事件跟踪,则可使用消息编译器来创建一个包含事件提供程序、事件属性、通道和事件的定义的头文件。 你必须在源代码中包括此头文件。 消息编译器将创建一个资源编译器脚本 (*.rc),你可以将其添加到项目文件中。
设置驱动程序项目的消息编译器属性
- 打开驱动程序项目的属性页。 在“解决方案资源管理器”中,选择并按住(或右键单击)驱动程序项目,然后选择“属性”。
- 在驱动程序项目的属性页中,选择“配置属性”,然后选择“消息编译器”。
- 设置项目属性。
如果你将消息文本文件 (.mc) 或清单 (.man) 添加到解决方案,则此属性页可用。
| 选项 | 说明 | 
|---|---|
| 其他选项 | 指定要传递至消息编译器 (MC.exe) 工具的其他选项。 | 
| Ansi 输入文件 | 指定输入文件包含 ANSI 内容(这是默认设置)。 (-a) | 
| Bin 文件中的 Ansi 消息 | 指定输出 .bin 文件中的消息应该为 ANSI。 (-A) | 
| 基线路径 | 此路径必须指向包含基线操作创建的 .BIN 文件的文件夹。 (-t <目录>) | 
| 基线资源路径 | 包含基线清单文件的文件夹。 (-s <目录>) | 
| 调试输出路径 | 用于放置 .dbg C 包含文件的路径。 (-x <路径>) | 
| 启用标注宏 | 添加标注宏,以便在日志记录时调用用户代码。 不适用于 C#,已忽略。 (-co) | 
| 启用调试输出路径 | 允许编译器放置由调试输出路径属性指定的 .dbg C 包含文件。 | 
| 生成的头文件的文件扩展名 | 指定生成的头文件的扩展名。 (-e <扩展名>) | 
| 生成基线资源 | 创建检测基线。 | 
| 生成 C# (托管)日志记录类 | 生成一个 C#(托管)日志记录类,你可以通过调用其中包含的方法来将事件记录到清单中。 (-cs <命名空间>) | 
| 生成包含计数器名称和 GUID 的头文件 | 使用此选项来指定你想要编译器在其中放置生成的头文件的文件夹。 | 
| 生成内核模式日志记录宏 | 生成内核模式日志记录宏。 (-km) | 
| 生成 MOF 文件 | 为所有函数和生成的宏生成下级支持。 MOF 文件将通过清单生成。 MOF 文件将置于 -h 选项 (-mof) 指定的位置。 | 
| 生成 OLE2 头文件 | 生成 OLE2 头文件。 (-o) | 
| 生成静态 C# (托管)日志记录类 | 生成一个静态 C#(托管)日志记录类,你可以通过调用其中包含的方法来将事件记录到清单中。 (-css <命名空间>) | 
| 生成用户模式日志记录宏 | 生成用户模式日志记录宏。 (-um) | 
| 生成文件基名 | 指定所有生成文件的基名。 (-z <基名>) | 
| 生成 RC 和二进制消息文件路径 | 指定生成的 RC 和二进制消息文件的路径。 | 
| 头文件路径 | 指定生成的头文件的路径。 (-h <路径>) | 
| 最大消息长度 | 使用此参数来让编译器在任何消息超出字符长度时生成警告。 (-m <长度>) | 
| 前缀宏名称 | 使用此参数来覆盖编译器用于记录宏名称和方法名称的默认前缀。 (-p <前缀>) | 
| RC 文件路径 | 你想要编译器在其中放置生成的资源编译器脚本 (.rc file) 和生成的 .bin 文件的文件夹。 (-r <路径>) | 
| 从符号名称中删除字符 | 使用此参数来从你为事件指定的符号名称开始删除字符。 (-P <前缀>) | 
| 设置客户位 | 在整个消息 ID 中设置客户位。 (-c) | 
| 终止 NULL 消息 | 终止消息表中为 NULL 的所有字符串。 (-n) | 
| Unicode 输入文件 | 指定包含 Unicode 内容的输入文件。 (-u) 默认值为 ANSI。 | 
| Bin 文件中的 Unicode 消息 | 指定输出 .bin 文件中的消息为 Unicode。 (-U) 这是默认情况。 | 
| 使用输入的基名 | 使用此参数可让编译器将输入文件的基名用作输出 .bin 文件的名称。 (-b) | 
| 使用十进制值 | 使用此参数即可在头文件的 Severity 和 Facility 常量中使用十进制值,而不是十六进制值。 (-d) | 
| 针对基线资源进行验证 | 当你创建新版清单并想要针对你使用 -s 选项创建的基线检查其是否与应用程序兼容时,可以使用此参数。 | 
| 详细 | 使用此选项来生成详细输出。 (-v) |