Поделиться через


Свойства компилятора сообщений для проектов драйверов

Задает свойства средства компилятора сообщений (MC.exe) . Компилятор создает файлы ресурсов сообщения, которые можно добавить в проект.

Например, если вы используете API трассировки событий для Windows (ETW) для добавления трассировки событий в драйвер режима ядра, можно использовать компилятор сообщений для создания файла заголовка, содержащего определения поставщика событий, атрибутов событий, каналов и событий. Этот файл заголовка необходимо включить в исходный код. Компилятор сообщений создает скрипт компилятора ресурсов (*.rc), который добавляется в файл проекта.

Настройка свойств компилятора сообщений для проектов драйверов

  1. Откройте страницы свойств для проекта драйвера. Выберите и удерживайте (или щелкните правой кнопкой мыши) проект драйвера в обозревателе решений и выберите "Свойства".
  2. На страницах свойств проекта драйвера выберите "Свойства конфигурации " и выберите "Компилятор сообщений".
  3. Задайте свойства для проекта.

Эта страница свойств доступна при добавлении текстового файла сообщения (MC) или манифеста (.man) в решение.

Вариант Описание

Дополнительные параметры

Указывает дополнительные параметры для передачи средству компилятора сообщений (MC.exe) .

Входной файл Ansi

Указывает, что входной файл содержит содержимое ANSI (это значение по умолчанию). ()

Сообщение ANSI в файле BIN

Указывает, что сообщения в выходном .bin файле должны быть ANSI. (-A)

Базовый путь

Путь должен указывать на папку, содержащую файлы .BIN, созданные базовой операцией. (-tкаталог)

Базовый путь к ресурсу

Папка, содержащая базовые файлы манифеста. (-sкаталог)

Отладочный путь вывода

Путь, где будет размещён файл включения C с расширением .dbg. (-xпуть)

Включение макроса выноски

Добавляет макрос выноски для вызова пользовательского кода при ведении журнала. Недоступно для C#и игнорируется. (-co)

Включение отладочного пути вывода

Позволяет компилятору поместить dbg C включаемый файл, указанный свойством путь вывода отладки .

Расширение файла для созданного заголовка

Задает расширение созданного файла заголовка. (-eрасширение)

Создание базового ресурса

Создает базис вашего инструментирования.

Создание класса ведения журнала C# (управляемого)

Создает управляемый класс ведения журнала C#, который включает методы, вызываемые для регистрации событий, определенных в вашем манифесте. (-csnamespace)

Создание файла заголовка для хранения имен счетчиков и идентификаторов GUID

Используйте этот параметр, чтобы указать папку, в которую нужно поместить созданный файл заголовка компилятора.

Создание макросов ведения журнала в режиме ядра

Создает макросы ведения журнала в режиме ядра. (-km)

Создание MOF-файла

Создайте поддержку нижнего уровня для всех функций и макросов, созданных. MOF-файл будет создан из манифеста. MOF-файл будет помещен в расположение, указанное параметром -h (-mof).

Создание заголовка OLE2

Создает файл заголовка OLE2. (-o)

Создание класса ведения журнала статического C# (управляемого)

Создает статический класс журнала на C# (управляемый), включающий методы, которые вы можете вызывать для регистрации событий в вашем манифесте. (-cssnamespace)

Создание макросов ведения журнала в режиме пользователя

Создание макросов ведения журнала в режиме пользователя. (-um)

Имя базы созданных файлов

Указывает базовое имя всех созданных файлов. (-zbasename)

Путь к созданным файлам RC и двоичных сообщений

Указывает путь к созданным файлам RC и двоичных сообщений.

Путь к файлу заголовка

Указывает путь к созданному файлу заголовка. (-hpath)

Максимальная длина сообщения

Используйте этот аргумент для создания компилятором предупреждения, если любое сообщение превышает длину символов. (длина)

Префиксное имя макроса

Используйте этот аргумент для переопределения префикса по умолчанию, используемого компилятором для имен макросов ведения журнала и имен методов. (-pпрефикс)

Путь к файлу RC

Папка, в которую требуется, чтобы компилятор помещал созданный скрипт компилятора ресурсов (RC-файл) и созданные .bin файлы. (-rpath)

Удаление символов из символьного имени

Используйте этот аргумент для удаления символов с начала символьного имени, указанного для события. (префиксP)

Настройка бита клиента

Задает бит клиента во всех идентификаторах сообщения. (-c)

Завершение сообщения с значением NULL

Завершает все строки со значениями NULL в таблицах сообщений. (-n)

Входной файл Юникода

Указывает, что входной файл содержит содержимое Юникода. (-u)

Значение по умолчанию — ANSI.

Сообщение Юникода в файле bin

Указывает, что сообщения в выходном .bin файле Юникод. (-U)

Это значение по умолчанию.

Использование базового имени входных данных

Используйте этот аргумент, чтобы компилятор использовал базовое имя входного файла для имени выходных .bin файлов. (-b)

Использование десятичных значений

Используйте этот аргумент, чтобы применять десятичные значения для констант серьезности и функции в файле заголовка вместо шестнадцатеричных значений. (-d)

Сравнение с базовым ресурсом

Используйте этот аргумент при создании новой версии манифеста, если хотите проверить его на совместимость приложений с базовой линией, созданной с помощью параметра -s.

Многословный

Используйте этот параметр для создания подробного вывода. (-v)