消息编译器任务

  • 项目

Windows 驱动程序工具包 (WDK) 提供 MessageCompiler 任务，以便你可以在使用 MSBuild 生成驱动程序时运行 MC.exe 工具。 有关使用 MC.exe 的信息，请参阅 消息编译器 (MC.exe) 。

MSBuild 使用 MessageCompile 项发送 MessageCompiler 任务的参数。 MessageCompile 项访问项目文件中 mc.exe 的项元数据。

以下示例演示如何编辑 .vcxproj 文件中的元数据。

<ItemGroup>
    <MessageCompile Include="a.mc">
      <GenerateBaselineResource>true</GenerateBaselineResource>
      <BaselineResourcePath>c:\test\</BaselineResourcePath>
    </MessageCompile>
</ItemGroup>

以下示例演示命令行调用：

mc.exe –s "c:\test\" a.mc

在上面的示例中，MSBuild 使用 –s 开关对文件 a.mc 调用 mc.exe，因为元数据 GenerateBaselineResource 设置为 true。 此外，MSBuild 使用 BaselineResourcePath 元数据来指定 –s 开关的参数。

MessageCompiler 任务参数 项元数据 工具开关
Sources

可选字符串参数。 指定要编译的清单文件的名称。 指定要编译的消息文件的名称。

 @ (MessageCompile)

<filename.man>

<filename.mc>
ANSIInputFile

指定输入文件为 ANSI (默认) 。

 % (MessageCompile.ANSIInputFile) -a
ANSIMessageInBinFile

指定 中的消息。BIN 文件应为 ANSI。

 % (MessageCompile.ANSIMessageInBinFile) -A
EnableDebugOutputPath

如果设置为 true，则启用 –x 开关。

 % (MessageCompile.EnableDebugOutputPath)
DebugOutputPath

指定编译器将 .dbg C 包含文件放置到的文件夹。 .dbg 文件将消息 ID 映射到其符号名称。

 % (MessageCompile.DebugOutputPath) -x<路径>
EnableCallOutMacro

添加标注宏以在日志记录期间调用用户代码。 此开关对 C# 无效，将被忽略。

 % (MessageCompile.EnableCallOutMacro) -co
EventmanPath

指定 eventman.xsd 文件的路径。

 % (MessageCompile.EventmanPath) -w<文件>
GenerateBaselineResource

如果设置为 true，则启用 -s 开关。

 % (MessageCompile.GenerateBaselineResource)
BaselineResourcePath

为每个提供程序生成二进制资源。 生成全局资源MCGenResource.BIN摘要。

 % (MessageCompile.BaselineResourcePath) -s<路径>
GenerateC#LoggingClass

生成 C# (基于 FX3.5 Eventing 类的托管) 日志记录类。

 % (MessageCompile.GenerateC#LoggingClass) -cs<命名空间>
GenerateC#StaticLoggingClass

生成静态 C# (基于 FX3.5 Eventing 类的托管) 日志记录类。

 % (MessageCompile.GenerateC#StaticLoggingClass) -css<命名空间>
GeneratedFilesBaseName

指定生成的文件的基名称。 默认值为输入文件的基名称。

 % (MessageCompile.GeneratedFilesBaseName) -z<basename>
GeneratedHeaderPath

如果设置为 true，则启用 -h 开关。

 % (MessageCompile.GeneratedHeaderPath)
HeaderFilePath

指定创建 C 包含文件的位置的路径。 默认值为 。

 % (MessageCompile.HeaderFilePath) -h<path>
GeneratedRcAndMessagesPath

如果设置为 true，则启用 -r 开关。

 % (MessageCompile.GeneratedRcAndMessagesPath)
RCFilePath

指定 RC 包含文件的路径及其包含的二进制消息资源文件。 默认值为 。

 % (MessageCompile.RCFilePath) -r<path>
GenerateKernelModeLoggingMacros

生成内核模式日志记录宏。

 % (MessageCompile.GenerateKernelModeLoggingMacros) -公里
GenerateMOFFile

生成对生成的所有函数和宏的下层支持。 MOF 文件是从清单生成的。 MOF 文件放置在“-h”开关指定的位置。

 % (MessageCompile.GenerateMOFFile) -Mof
GenerateOLE2Header

生成 OLE2 头文件。 使用 HRESULT 定义而不是状态代码定义。

 % (MessageCompile.GenerateOLE2Header) -o
GenerateUserModeLoggingMacros

生成用户模式日志记录宏。

 % (MessageCompile.GenerateUserModeLoggingMacros) -um
HeaderExtension

指定头文件的扩展名 (1-3 个字符) 。

 % (MessageCompile.HeaderExtension) -e<扩展>
MaximumMessageLength

如果任何消息的大小超过 <长度> 字符，则生成警告。

 % (MessageCompile.MaximumMessageLength) -m<长度>
PrefixMacroName

定义应用于每个生成的日志记录宏的宏名称前缀。 默认值为“EventWrite”。

 % (MessageCompile PrefixMacroName) -p<前缀>
RemoveCharsFromSymbolName

定义在形成宏名称之前要删除的每个事件符号名称开头的文本。 默认值为 NULL。

 % (RemoveCharsFromSymbolName) -P<前缀>
SetCustomerbit

在整个消息 ID 中设置客户位。

 % (MessageCompile.SetCustomerbit) -c
TerminateMessageWithNull

终止消息表中具有 null 字符的所有字符串。

 % (MessageCompile.TerminateMessageWithNull) -n
UnicodeInputFile

输入文件为 Unicode。

 % (MessageCompile.UnicodeInputFile) -u
UnicodeMessageInBinFile

中的消息。BIN 文件应为 unicode (默认) 。

 % (MessageCompile.UnicodeMessageInBinFile) -U
UseBaseNameOfInput

指定 。为了保持唯一性，BIN 文件名应包含 .mc 文件名。

 % (MessageCompile。UseBaseNameOfInput) -b
UseDecimalValues

以十进制形式指定头文件中的 FACILTY 和 SEVERITY 值。 最初将标头中的消息值设置为十进制。

 % (MessageCompile.UseDecimalValues) -d
ValidateAgainstBaselineResource

如果此值设置为 true，则生成 -t 开关。

 % (MessageCompile.ValidateAgainstBaselineResource)
BaselinePath

针对基线资源进行验证。

 % (MessageCompile.BaselinePath) -t<路径>
详细

指定详细输出。

 % (MessageCompile.Verbose) -v
WinmetaPath

指定 winmeta.xml 文件的路径。

 % (MessageCompile.WinmetaPath) -W<文件>

消息编译器 (MC.exe)