Compartilhar via

Propriedades do compilador de mensagens para projetos de driver

  • Artigo

Define as propriedades da ferramenta Compilador de Mensagens (MC.exe). O compilador gera os arquivos de recurso de mensagem que você pode adicionar ao seu projeto.

Por exemplo, se você estiver usando a API do modo kernel ETW (Rastreamento de Eventos para Windows) para adicionar o rastreamento de eventos a um driver do modo kernel, poderá usar o compilador de mensagens para criar um arquivo de cabeçalho que contenha definições para o provedor de eventos, atributos de evento, canais e eventos. Você deve incluir esse arquivo de cabeçalho em seu código-fonte. O compilador de mensagens cria um script do compilador de recursos (*.rc) que você adiciona ao arquivo de projeto.

Configurando propriedades do Compilador de Mensagens para projetos de driver

  1. Abra as páginas de propriedades do projeto do driver. Selecione e segure (ou clique com o botão direito do mouse) no projeto de driver no Gerenciador de Soluções e selecione Propriedades.
  2. Nas páginas de propriedades do projeto de driver, selecione Propriedades de Configuração e, em seguida, selecione Compilador de Mensagens.
  3. Defina as propriedades do projeto.

Essa página de propriedades estará disponível se você adicionar um arquivo de texto de mensagem (.mc) ou um manifesto (.man) à sua solução.

Opção Descrição

Opções adicionais

Especifica opções adicionais a serem passadas para a ferramenta Compilador de Mensagens (MC.exe).

Arquivo de entrada Ansi

Especifica que o arquivo de entrada contém conteúdo ANSI (esse é o padrão). (-uma)

Mensagem Ansi no arquivo Bin

Especifica que as mensagens no arquivo de .bin de saída devem ser ANSI. (-A)

Caminho da linha de base

O caminho deve apontar para a pasta que contém o arquivo . BIN criados pela operação de linha de base. (diretório -t)

Caminho de recursos de linha de base

A pasta que contém os arquivos de manifesto de linha de base. (diretório -s)

Caminho de saída de depuração

O caminho no qual colocar o arquivo de inclusão C .dbg. (caminho -x)

Ativar macro de texto explicativo

Adiciona uma macro de texto explicativo para invocar o código do usuário no log. Não disponível para C# e ignorado. (-co)

Habilitar caminho de saída de depuração

Permite que o compilador coloque o arquivo de inclusão .dbg C especificado pela propriedade Caminho de Saída de Depuração .

Extensão de arquivo para o cabeçalho gerado

Especifica a extensão do arquivo de cabeçalho gerado. (-e extensão)

Gerar recurso de linha de base

Cria uma linha de base de sua instrumentação.

Gerar classe de log C# (gerenciada)

Gera uma classe de log C# (gerenciada) que inclui métodos que você chamaria para registrar eventos em seu manifesto. (namespace -cs)

Gerar arquivo de cabeçalho para conter nomes de contadores e GUIDs

Use essa opção para especificar a pasta na qual você deseja que o compilador coloque o arquivo de cabeçalho gerado.

Gerar macros de log do modo kernel

Gera macros de log no modo kernel. (-km)

Gerar arquivo MOF

Gere suporte de nível inferior para todas as funções e macros geradas. MOF será gerado a partir do manifesto. MOF será colocado no local especificado pela opção -h (-mof).

Gerar cabeçalho OLE2

Gera um arquivo de cabeçalho OLE2. (-o)

Gerar classe de log C# estática (gerenciada)

Gera uma classe de log C# estática (gerenciada) que inclui métodos que você chamaria para registrar eventos em seu manifesto. (namespace -css)

Gerar macros de log do modo de usuário

Gere macros de log no modo de usuário. (-um)

Nome Base dos Arquivos Gerados

Especifica o nome base de todos os arquivos gerados. (-z nome base)

Caminho de arquivos de mensagens binárias e RC gerado

Especifica o caminho para os arquivos de mensagens RC e binárias gerados.

Caminho do arquivo de cabeçalho

Especifica o caminho do arquivo de cabeçalho gerado. (caminho -h)

Comprimento máximo da mensagem

Use esse argumento para que o compilador gere um aviso se alguma mensagem exceder caracteres de comprimento. (comprimento de -m)

Nome da macro de prefixo

Use esse argumento para substituir o prefixo padrão que o compilador usa para os nomes de macro de log e nomes de método. (prefixo -p)

Caminho do arquivo RC

A pasta na qual você deseja que o compilador coloque o script do compilador de recursos gerado (arquivo .rc) e os arquivos .bin gerados. (caminho -r)

Remover caracteres do nome simbólico

Use esse argumento para remover caracteres do início do nome simbólico que você especificou para o evento. (prefixo -P)

Definir bit do cliente

Define o bit Customer em todas as IDs de mensagem. (-c)

Encerrar mensagem com nulo

Encerra todas as cadeias de caracteres com nulos nas tabelas de mensagens. (-n)

Arquivo de entrada Unicode

Especifica que o arquivo de entrada contém conteúdo Unicode. (-u)

O padrão é ANSI.

Mensagem Unicode no arquivo Bin

Especifica que as mensagens no arquivo de .bin de saída são Unicode. (-U)

Esse é o padrão.

Usar nome base da entrada

Use esse argumento para que o compilador use o nome base do arquivo de entrada para o nome dos arquivos de .bin de saída. (-b)

Usar valores decimais

Use esse argumento para usar valores decimais para as constantes Severity e Facility no arquivo de cabeçalho em vez de valores hexadecimais. (-d)

Validar em relação ao recurso de linha de base

Use esse argumento ao criar uma nova versão do manifesto e quiser verificar a compatibilidade do aplicativo em relação à linha de base criada usando a opção -s .

Detalhado

Use essa opção para gerar uma saída detalhada. (-v)