Partilhar via

Propriedades do compilador de mensagens para projetos de driver

Define as propriedades da ferramenta Message Compiler (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 de modo kernel do Rastreamento de Eventos para Windows (ETW) para adicionar o rastreamento de eventos a um driver de 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 eventos, canais e eventos. Você deve incluir esse arquivo de cabeçalho em seu código-fonte. O compilador de mensagens cria um script de compilador de recursos (*.rc) que você adiciona ao seu arquivo de projeto.

Definindo propriedades do compilador de mensagens para projetos de driver

  1. Abra as páginas de propriedades do seu projeto de driver. Selecione e segure (ou clique com o botão direito do mouse) o 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.

Esta 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 Message Compiler (MC.exe).

Arquivo de entrada ANSI

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

Mensagem Ansi no ficheiro Bin

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

Caminho base

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

Caminho do recurso da linha de base

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

Depurar caminho de saída

O caminho no qual colocar o arquivo .dbg C include. (-xcaminho)

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)

Ativar caminho de saída de depuração

Permite que o compilador coloque o arquivo .dbg C include especificado pela propriedade Debug Output Path .

Extensão de arquivo para o cabeçalho gerado

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

Gerar recurso de linha de base

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

Gerar classe de log em C# (gerenciado)

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

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

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

Gerar macros de registo em modo de núcleo

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. O arquivo 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. (-cssnamespace)

Gerar macros de log no 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. (-zbasename)

Caminho dos ficheiros RC e de mensagens binárias gerados

Especifica o caminho para os arquivos de mensagem binária e RC gerados.

Caminho do arquivo de cabeçalho

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

Comprimento máximo da mensagem

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

Nome da macro do 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. (-pprefixo)

Caminho do arquivo RC

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

Remover caracteres do nome simbólico

Use esse argumento para remover caracteres do início do nome simbólico especificado para o evento. (-Pprefixo)

Definir bit do cliente

Define-se o bit do cliente nos Ids de todas as mensagens. (-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)

Este é 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 referência

Use esse argumento quando criar uma nova versão do manifesto e quiser verificá-lo quanto à compatibilidade do aplicativo em relação à linha de base que você criou usando a opção -s .

Verbose

Use esta opção para gerar uma saída detalhada. (-v)
  • Last updated on