共用方式為


驅動程式專案的訊息編譯程序屬性

設定 訊息編譯程式 (MC.exe) 工具的屬性。 編譯程式會產生訊息資源檔,您可以新增至專案。

例如,如果您使用 Windows 事件追蹤 (ETW) 核心模式 API 將事件追蹤新增至內核模式驅動程式,您可以使用訊息編譯程式來建立頭檔,其中包含事件提供者、事件屬性、通道和事件的定義。 您必須在原始程式碼包含此標頭檔。 訊息編譯程式會建立您新增至專案檔的資源編譯程式腳本 (*.rc)。

設定驅動程式專案的訊息編譯程序屬性

  1. 開啟驅動程式項目的屬性頁。 選取並按住 [ 方案總 管] 中的驅動程式專案,然後按滑鼠右鍵,然後選取 [ 屬性]。
  2. 在驅動程式項目的屬性頁面中,選取 [ 組態屬性 ],然後選取 [ 訊息編譯程式]。
  3. 設定項目的屬性。

如果您將消息文本檔 (.mc) 或指令清單 (.man) 新增至您的解決方案,則可以使用這個屬性頁。

選項 說明

其他選項

指定要傳遞至 訊息編譯程式 (MC.exe) 工具的其他選項。

Ansi 輸入檔

指定輸入檔包含 ANSI 內容(這是預設值)。 (-a

Bin 檔案中的 Ansi 訊息

指定輸出.bin檔案中的訊息應該是 ANSI。 (-A

基準路徑

路徑必須指向包含基準作業所建立的 .BIN 檔案的資料夾。 (-t目錄

基準資源路徑

包含基準指令清單檔案的資料夾。 (-s目錄

偵錯輸出路徑

放置 .dbg C include 檔案的路徑。 (-x路徑

啟用標註巨集

新增註標巨集,以在記錄時叫用使用者程序代碼。 不適用於 C#,並且被忽略。 (

啟用偵錯輸出路徑

可讓編譯程式放置偵錯 輸出路徑 屬性所指定的 .dbg C include 檔案。

所產生標題的檔案副檔名

指定產生的頭檔擴展名。 (-e擴充功能

產生基準資源

建立儀器的基準。

產生 C# (Managed) 記錄類別

產生 C# (受控)記錄類別,其中包含您要呼叫以在清單文件中記錄事件的方法。 (-cs命名空間

產生包含計數器名稱和 GUID 的頭檔

使用此選項可指定您要編譯程式放置所產生頭文件的資料夾。

產生核心模式記錄巨集

生成核心模式記錄宏。 (-公里

產生MOF檔案

為所有產生的函式和巨集提供向下相容性的支援。 MOF 檔案將會從指令清單產生。 MOF 檔案會放在 -h 選項 (-mof) 所指定的位置。

產生 OLE2 標頭

產生 OLE2 頭檔。 (-o

產生靜態 C# (Managed) 記錄類別

產生靜態 C# (Managed) 記錄類別,其中包含您要在指令清單中呼叫以記錄事件的方法。 (-css命名空間

產生使用者模式記錄巨集

產生使用者模式記錄巨集。 (-um

產生的檔案基底名稱

指定所有產生的檔案的基底名稱。 (-zbasename

產生的 RC 和二進位訊息檔案路徑

指定產生的 RC 和二進位訊息檔的路徑。

標頭檔案路徑

指定產生的頭文件路徑。 (-h路徑

訊息長度上限

使用此自變數讓編譯程式在有任何訊息超過長度字元時產生警告。 (-m長度

前置詞巨集名稱

使用此自變數覆寫編譯程式用於記錄巨集名稱和方法名稱的預設前置詞。 (-p前置詞

RC 檔案路徑

您希望編譯程式將產生的資源編譯程式腳本 (.rc 檔案) 和產生的.bin檔案放入其中的資料夾。 (-r路徑

從符號名稱中移除字元

使用此自變數從您為事件指定的符號名稱開頭移除字元。 (-P前置詞

設定客戶位

設定整個訊息識別碼中的「Customer 位」。 (-c

以 Null 終止訊息

終止訊息數據表中具有 Null 的所有字串。 (-n

Unicode 輸入檔

指定輸入檔包含 Unicode 內容。 (-u

預設值為 ANSI。

Bin 檔案中的 Unicode 訊息

指定輸出.bin檔案中的訊息為 Unicode。 (-U

這是預設值。

使用輸入的基底名稱

使用此自變數讓編譯程式針對輸出.bin檔案的名稱,使用輸入檔的基底名稱。 (-b

使用十進位值

使用此自變數來使用頭檔中嚴重性和設備常數的十進位值,而不是十六進位值。 (-d

根據基準資源進行驗證

當您建立新版本的組態清單,並想要檢查它是否與您使用 -s 選項建立的基準相容時,請使用這個參數。

冗長

使用此選項來產生詳細信息輸出。 (-v