メッセージ コンパイラ (MC.exe) ツールのプロパティを設定します。 コンパイラは、プロジェクトに追加できるメッセージリソースファイルを生成します。
たとえば、Event Tracing for Windows (ETW) カーネル モード API を使用してイベント トレースをカーネル モード ドライバーに追加している場合、メッセージ コンパイラーを使用して、イベント プロバイダーの定義を含むヘッダー ファイルを作成できます。属性、チャネル、イベント。 このヘッダーファイルをソースコードに含める必要があります。 メッセージ コンパイラでは、プロジェクト ファイルに追加するリソース コンパイラ スクリプト (*.rc) が作成されます。
ドライバー プロジェクト用のメッセージ コンパイラ プロパティの設定
- ドライバープロジェクトのプロパティページを開きます。 ソリューション エクスプローラーでドライバー プロジェクトを長押し (または右クリック) し、[プロパティ] を選びます。
- ドライバー プロジェクトのプロパティ ページで、[構成プロパティ]、[Message Compiler]\(メッセージ コンパイラ\) の順に選びます。
- プロジェクトのプロパティを設定します。
このプロパティページは、メッセージ テキストファイル (.mc) またはマニフェスト (.man) をソリューションに追加した場合に使用できます。
| オプション | 説明 |
|---|---|
Additional Options (追加オプション) |
メッセージ コンパイラ (MC.exe) ツールに渡す追加オプションを指定します。 |
Ansi Input File (ANSI 入力ファイル) |
入力ファイルに ANSI コンテンツが含まれることを指定します (これがデフォルトです)。 (-a) |
Ansi Message In Bin File (Bin ファイル内の ANSI メッセージ) |
出力 .binファイル内のメッセージがANSIである必要があることを指定します。 (-A) |
Baseline Path (ベースライン パス) |
パスは、ベースライン操作で作成された .BINファイルを含むフォルダーを指す必要があります。 (-t directory) |
Baseline Resource Path (ベースライン リソース パス) |
ベースラインマニフェストファイルが含まれるフォルダー。 (-s directory) |
Debug Output Path (デバッグ出力パス) |
.dbg Cインクルードファイルを配置するパス。 (-x path) |
Enable Callout Macro (コールアウト マクロを有効にする) |
ロギング時にユーザーコードを呼び出すコールアウト マクロを追加します。 C# では使用できないため、無視されます。 (-co) |
Enable Debug Output Path (デバッグ出力パスを有効にする) |
コンパイラーが、デバッグアウトプットパスプロパティーで指定された .dbg Cインクルード ファイルを配置できるようにします。 |
File extension for the generated header (生成されたヘッダーのファイル拡張子) |
生成されるヘッダーファイルの拡張子を指定します。 (-e extension) |
Generate Baseline Resource (ベースライン リソースを生成する) |
インストルメンテーションのベースラインを作成します。 |
Generate C# (managed) logging class (C# (マネージ) ログ記録クラスを生成する) |
マニフェスト内のイベントをログに記録するために呼び出すメソッドを含む C# (マネージド) ログクラスを生成します。 (-cs namespace) |
Generate header file for containing counter names and GUIDs (カウンター名と GUID を格納するためのヘッダー ファイルを生成する) |
このオプションを使用して、コンパイラーが生成したヘッダーファイルを配置するフォルダーを指定します。 |
Generate Kernel Mode Logging Macros (カーネル モード ログ記録マクロを生成する) |
カーネルモードのロギングマクロを生成します。 (-キロ) |
Generate MOF File (MOF ファイルを生成する) |
生成されたすべての関数とマクロに対する下位レベルのサポートを生成します。 MOFファイルはマニフェストから生成されます。 MOFファイルは、-h オプション (-mof) で指定された場所に配置されます。 |
Generate OLE2 Header (OLE2 ヘッダーを生成する) |
OLE2 ヘッダー ファイルを生成します。 (-o) |
Generate static C# (managed) logging class (静的な C# (マネージ) ログ記録クラスを生成する) |
マニフェスト内のイベントをログに記録するために呼び出すメソッドを含む静的 C# (マネージド) ログ クラスを生成します。 (-css namespace) |
Generate User Mode Logging Macros (ユーザー モードのログ記録マクロを生成する) |
ユーザーモードロギングマクロを生成します。 (-um) |
Generated Files Base Name (生成されるファイルのベース名) |
生成されるすべてのファイルのベース名を指定します。 (-z basename) |
Generated RC and Binary Message Files Path (生成される RC ファイルとバイナリ メッセージ ファイルのパス) |
生成された RC およびバイナリ メッセージ ファイルへのパスを指定します。 |
Header File Path (ヘッダー ファイル パス) |
生成されるヘッダーファイルのパスを指定します。 (-h path) |
Maximum Message Length (メッセージの最大長) |
この引数を使用すると、メッセージが文字数を超えた場合にコンパイラに警告が生成されます。 (-m length) |
Prefix Macro Name (マクロ名のプレフィックス) |
この引数を使用して、コンパイラがロギングマクロ名およびメソッド名に使用するデフォルトのプレフィックスをオーバーライドします。 (-p prefix) |
RC File Path (RC ファイル パス) |
コンパイラが生成されたリソースコンパイラ スクリプト (.rc ファイル) と生成された .binファイルを配置するフォルダ。 (-r path) |
Remove Characters From Symbolic Name (シンボリック名から文字を削除する) |
この引数を使用して、イベントに指定したシンボリック名の先頭から文字を削除します。 (-P prefix) |
Set Customer Bit (カスタマー ビットを設定する) |
メッセージ ID 全体に顧客ビットを設定します。 (-c) |
Terminate Message With Null (メッセージを null で終了させる) |
メッセージテーブル内のすべての文字列を nullで終了します。 (-n) |
Unicode Input File (Unicode 入力ファイル) |
入力ファイルに ユニコードコンテンツが含まれることを指定します。 (-u) 既定値は ANSI です。 |
Unicode Message In Bin File (Bin ファイル内の Unicode メッセージ) |
出力 .binファイル内のメッセージがユニコードであることを指定します。 (-U) これが既定です。 |
Use Base Name Of Input (入力のベース名を使う) |
この引数を使用すると、コンパイラが出力 .binファイルの名前として入力ファイルのベース名を使用するようになります。 (-b) |
Use Decimal Values (10 進値を使う) |
この引数を使用して、ヘッダーファイルの深刻定数と施設定数に16進値ではなく10進値を使用します。 (-d) |
Validate Against Baseline Resource (ベースライン リソースに照らして検証する) |
この引数は、マニフェストの新しいバージョンを作成し、-s オプションを使用して作成したベースラインとのアプリケーションの互換性をチェックする場合に使用します。 |
Verbose |
このオプションを使用して、詳細な出力を生成します。 (-v) |