Compartir vía

Propiedades del compilador de mensajes para proyectos de controladores

  • Artículo

Establece las propiedades de la herramienta Compilador de mensajes (MC.exe). El compilador genera los archivos de recursos de mensaje que puede agregar al proyecto.

Por ejemplo, si usa la API del modo kernel de Seguimiento de eventos para Windows (ETW) para agregar el seguimiento de eventos a un controlador en modo kernel, puede usar el compilador de mensajes para crear un archivo de encabezado que contenga definiciones para el proveedor de eventos, atributos de evento, canales y eventos. Debe incluir este archivo de encabezado en el código fuente. El compilador de mensajes crea un script del compilador de recursos (*.rc) que se agrega al archivo del proyecto.

Establecimiento de las propiedades del compilador de mensajes para proyectos de controladores

  1. Abra las páginas de propiedades del proyecto del controlador. Seleccione y mantenga presionado (o haga clic con el botón derecho) en el proyecto de controlador en Explorador de soluciones y seleccione Propiedades.
  2. En las páginas de propiedades del proyecto de controlador, seleccione Propiedades de configuración y, a continuación, seleccione Compilador de mensajes.
  3. Establezca las propiedades del proyecto.

Esta página de propiedades está disponible si agrega un archivo de texto de mensaje (.mc) o un manifiesto (.man) a la solución.

Opción Descripción

Opciones adicionales

Especifica opciones adicionales para pasar a la herramienta Compilador de mensajes (MC.exe).

Archivo de entrada ansi

Especifica que el archivo de entrada contiene contenido ANSI (este es el valor predeterminado). (-a)

Mensaje Ansi en el archivo bin

Especifica que los mensajes del archivo de salida .bin deben ser ANSI. (-A)

Ruta de referencia

La ruta de acceso debe apuntar a la carpeta que contiene . Archivos BIN creados por la operación de línea base. (-t directory)

Ruta de acceso del recurso de línea base

Carpeta que contiene los archivos de manifiesto de línea base. (-s directory)

Ruta de acceso de salida de depuración

Ruta de acceso en la que se va a colocar el archivo de inclusión de .dbg C. (-x ruta)

Habilitar macro de llamada

Agrega una macro de llamada para invocar código de usuario al iniciar sesión. No está disponible para C#y se omite. (-co)

Habilitación de la ruta de acceso de salida de depuración

Permite al compilador colocar el archivo de inclusión .dbg C especificado por la propiedad Ruta de acceso de salida de depuración.

Extensión de archivo para el encabezado generado

Especifica la extensión del archivo de encabezado generado. (-e extensión)

Generación de un recurso de línea base

Crea una línea base de la instrumentación.

Generación de la clase de registro de C# (administrado)

Genera una clase de registro de C# (administrada) que incluye métodos a los que llamaría para registrar eventos en el manifiesto. (-cs namespace)

Generación de un archivo de encabezado para contener nombres de contadores y GUID

Use esta opción para especificar la carpeta en la que desea que el compilador coloque el archivo de encabezado generado.

Generar macros de registro en modo kernel

Genera macros de registro en modo kernel. (-km)

Generar archivo MOF

Genere compatibilidad de nivel descendente para todas las funciones y macros generadas. El archivo MOF se generará a partir del manifiesto. El archivo MOF se colocará en la ubicación especificada por la opción -h (-mof).

Generar encabezado OLE2

Genera un archivo de encabezado OLE2. (-o)

Generación de una clase de registro estática de C# (administrado)

Genera una clase de registro estática de C# (administrada) que incluye métodos a los que llamaría para registrar eventos en el manifiesto. (-css namespace)

Generar macros de registro en modo de usuario

Generar macros de registro en modo de usuario. (-mmm)

Nombre base de archivos generados

Especifica el nombre base de todos los archivos generados. (-z basename)

Ruta de acceso de archivos de mensajes rc y binarios generados

Especifica la ruta de acceso a los archivos de mensaje RC y binarios generados.

Ruta de acceso del archivo de encabezado

Especifica la ruta de acceso al archivo de encabezado generado. (-h path)

Longitud máxima del mensaje

Use este argumento para que el compilador genere una advertencia si algún mensaje supera los caracteres de longitud. (-m longitud)

Nombre de macro de prefijo

Use este argumento para invalidar el prefijo predeterminado que usa el compilador para los nombres de macros de registro y nombres de método. (-p prefijo)

Ruta de acceso del archivo RC

Carpeta en la que desea que el compilador coloque el script del compilador de recursos generado (archivo .rc) y los archivos de .bin generados. (-r path)

Quitar caracteres del nombre simbólico

Use este argumento para quitar caracteres del principio del nombre simbólico que especificó para el evento. (-P prefijo)

Establecer bit de cliente

Establece el bit Customer en todos los identificadores de mensaje. (-c)

Finalizar mensaje con null

Finaliza todas las cadenas con valores NULL en las tablas de mensajes. (-n)

Archivo de entrada Unicode

Especifica que el archivo de entrada contiene contenido Unicode. (-u)

El valor predeterminado es ANSI.

Mensaje Unicode en el archivo bin

Especifica que los mensajes del archivo .bin de salida son Unicode. (-U)

Esta es la configuración predeterminada.

Usar el nombre base de la entrada

Use este argumento para que el compilador use el nombre base del archivo de entrada para el nombre de los archivos de salida .bin. (-b)

Usar valores decimales

Use este argumento para usar valores decimales para las constantes Gravedad y Facility en el archivo de encabezado en lugar de valores hexadecimales. (-d)

Validar con el recurso de línea base

Use este argumento cuando cree una nueva versión del manifiesto y quiera comprobar la compatibilidad de la aplicación con la línea base que creó con la opción -s .

Detallado

Use esta opción para generar una salida detallada. (-v)