Tarea del compilador de mensajes

El Kit de controladores de Windows (WDK) proporciona la tarea MessageCompiler para que pueda ejecutar la herramienta de MC.exe al compilar el controlador mediante MSBuild. Para obtener información sobre el uso de MC.exe, vea Compilador de mensajes (MC.exe).

MSBuild usa el elemento MessageCompile para enviar los parámetros de la tarea MessageCompiler. El elemento MessageCompile accede a los metadatos del elemento para mc.exe en los archivos del proyecto.

En el ejemplo siguiente se muestra cómo editar los metadatos en el archivo .vcxproj.

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

En el ejemplo siguiente se muestra la invocación de la línea de comandos:

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

En el ejemplo anterior, MSBuild invoca mc.exe en el archivo a.mc, con el modificador –s porque los metadatos GenerateBaselineResource se establecen en true. Además, MSBuild usa los metadatos baselineResourcePath para especificar el argumento para el modificador –s.

Parámetro de tarea MessageCompiler	Metadatos de elementos	Conmutador de herramienta
Sources Parámetro de cadena opcional. Especifica el nombre del archivo de manifiesto que se va a compilar. Especifica el nombre de un archivo de mensaje que se va a compilar.	@(MessageCompile)	<filename.man> <filename.mc>
ANSIInputFile Especifica que el archivo input es ANSI (valor predeterminado).	%(MessageCompile.ANSIInputFile)	-a
ANSIMessageInBinFile Especifica que los mensajes de . El archivo BIN debe ser ANSI.	%(MessageCompile.ANSIMessageInBinFile)	-A
EnableDebugOutputPath Si se establece en true, habilita el modificador –x.	%(MessageCompile.EnableDebugOutputPath)
DepurarOutputPath Especifica la carpeta en la que el compilador coloca el archivo de inclusión .dbg C. El archivo .dbg asigna los identificadores de mensaje a sus nombres simbólicos.	%(MessageCompile.DebugOutputPath)	-x<ruta de acceso>
EnableCallOutMacro Agrega la macro de llamada para invocar código de usuario durante el registro. Este modificador no es válido para C# y se omite.	%(MessageCompile.EnableCallOutMacro)	-Co
EventmanPath Especifica la ruta de acceso al archivo eventman.xsd.	%(MessageCompile.EventmanPath)	-w<archivo>
GenerateBaselineResource Si se establece en true, habilita el modificador -s.	%(MessageCompile.GenerateBaselineResource)
BaselineResourcePath Genera un recurso binario por proveedor. Genera MCGenResource.BIN de recursos globales de resumen.	%(MessageCompile.BaselineResourcePath)	-s<path>
GenerateC#LoggingClass Genera una clase de registro de C# (administrada) basada en la clase Eventing FX3.5.	%(MessageCompile.GenerateC#LoggingClass)	Espaciode nombres> -cs<
GenerateC#StaticLoggingClass Genera una clase de registro estática de C# (administrada) basada en la clase Eventing FX3.5.	%(MessageCompile.GenerateC#StaticLoggingClass)	Espaciode nombres> -css<
GeneratedFilesBaseName Especifica el nombre base de los archivos generados. El valor predeterminado es el nombre base del archivo de entrada.	%(MessageCompile.GeneratedFilesBaseName)	-z<basename>
GeneratedHeaderPath Si se establece en true, habilita el modificador -h.	%(MessageCompile.GeneratedHeaderPath)
HeaderFilePath Especifica la ruta de acceso de dónde crear el archivo de inclusión de C. El valor predeterminado es ..	%(MessageCompile.HeaderFilePath)	-h<path>
GeneratedRcAndMessagesPath Si se establece en true, habilita el modificador -r.	%(MessageCompile.GeneratedRcAndMessagesPath)
RCFilePath Especifica la ruta de acceso del RC incluye archivos y los archivos de recursos de mensajes binarios que incluye. El valor predeterminado es ..	%(MessageCompile.RCFilePath)	-r<path>
GenerateKernelModeLoggingMacros Genera macros de registro del modo kernel.	%(MessageCompile.GenerateKernelModeLoggingMacros)	-Km
GenerateMOFFile Genera compatibilidad de nivel descendente para todas las funciones y macros que se generan. El archivo MOF se genera a partir del manifiesto. El archivo MOF se coloca en la ubicación especificada por el modificador "-h".	%(MessageCompile.GenerateMOFFile)	-Mof
GenerateOLE2Header Genera el archivo de encabezado OLE2. Usa la definición HRESULT en lugar de la definición de código de estado.	%(MessageCompile.GenerateOLE2Header)	-o
GenerateUserModeLoggingMacros Genera macros de registro en modo de usuario.	%(MessageCompile.GenerateUserModeLoggingMacros)	-um
HeaderExtension Especifica la extensión para el archivo de encabezado (1-3 caracteres).	%(MessageCompile.HeaderExtension)	-e<extensión>
MaximumMessageLength Genera una advertencia si el tamaño de cualquier mensaje supera los <caracteres de longitud> .	%(MessageCompile.MaximumMessageLength)	-m<longitud>
PrefixMacroName Define el prefijo de nombre de macro que se aplica a cada macro de registro generada. El valor predeterminado es "EventWrite".	%(MessageCompile PrefixMacroName)	-p<prefijo>
RemoveCharsFromSymbolName Define el texto al principio de cada nombre de símbolo de evento que se va a quitar antes de formar los nombres de macro. El valor predeterminado es NULL.	%(RemoveCharsFromSymbolName)	Prefijo>-P<
SetCustomerbit Establece el bit Customer en todos los identificadores de mensaje.	%(MessageCompile.SetCustomerbit)	-c
TerminateMessageWithNull Finaliza todas las cadenas con caracteres NULL en las tablas de mensajes.	%(MessageCompile.TerminateMessageWithNull)	-n
UnicodeInputFile El archivo de entrada es Unicode.	%(MessageCompile.UnicodeInputFile)	-u
UnicodeMessageInBinFile Mensajes de . El archivo BIN debe ser Unicode (valor predeterminado).	%(MessageCompile.UnicodeMessageInBinFile)	-U
UseBaseNameOfInput Especifica que . El nombre de archivo BIN debe tener el nombre de archivo .mc incluido para la unicidad.	%(MessageCompile. UseBaseNameOfInput)	-b
UseDecimalValues Especifica los valores FACILTY y SEVERITY del archivo de encabezado en decimal. Establece los valores del mensaje en el encabezado en decimal inicialmente.	%(MessageCompile.UseDecimalValues)	-d
ValidateAgainstBaselineResource Si se establece en true, genera el modificador -t.	%(MessageCompile.ValidateAgainstBaselineResource)
BaselinePath Valida con el recurso de línea base.	%(MessageCompile.BaselinePath)	-t<ruta de acceso>
Detallado Especifica la salida detallada.	%(MessageCompile.Verbose)	-v
WinmetaPath Especifica la ruta de acceso al archivo winmeta.xml.	%(MessageCompile.WinmetaPath)	-W<archivo>

Temas relacionados

Compilador de mensajes (MC.exe)