ドライバー プロジェクトのメッセージ コンパイラ プロパティ
Message Compiler (MC.exe) ツール用のプロパティを設定します。コンパイラは、プロジェクトに追加できるメッセージ リソース ファイルを生成します。
たとえば、Windows イベント トレーシング (ETW) カーネル モード API を使ってカーネル モード ドライバーにイベント トレーシングを追加している場合、メッセージ コンパイラを使って、イベント プロバイダー、イベント属性、チャネル、イベントの定義を含むヘッダー ファイルを作ることができます。ソース コードには、このヘッダー ファイルをインクルードする必要があります。メッセージ コンパイラでは、プロジェクト ファイルに追加するリソース コンパイラ スクリプト (*.rc) が作成されます。
ドライバー プロジェクト用のメッセージ コンパイラ プロパティの設定
- ドライバー プロジェクトのプロパティ ページを開きます。ソリューション エクスプローラーでドライバー プロジェクトを右クリックして、[プロパティ] をクリックします。
- ドライバー プロジェクトのプロパティ ページで、[構成プロパティ]、[Message Compiler] (メッセージ コンパイラ) の順にクリックします。
- プロジェクトのプロパティを設定します。
このプロパティ ページを使えるのは、ソリューションにメッセージ テキスト ファイル (.mc) かマニフェスト (.man) を追加した場合のみです。
| オプション | 説明 |
|---|---|
追加オプション |
Message Compiler (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 (デバッグ出力パスを有効にする) |
コンパイラを有効にして [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 (カーネル モード ログ記録マクロを生成する) |
カーネル モード ログ記録マクロを生成します。(-km) |
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 入力ファイル) |
入力ファイルが Unicode コンテンツを含むことを指定します。(-u) 既定は ANSI です。 |
Unicode Message In Bin File (Bin ファイル内の Unicode メッセージ) |
出力 .bin ファイル内のメッセージが Unicode であることを指定します。(-U) これが既定値です。 |
Use Base Name Of Input (入力のベース名を使う) |
コンパイラが出力 .bin ファイルの名前に入力ファイルのベース名を使うようにするには、この引数を使います。(-b) |
Use Decimal Values (10 進値を使う) |
ヘッダー ファイル内の Severity 定数と Facility 定数に 16 進値ではなく 10 進値を使うには、この引数を使います。(-d) |
Validate Against Baseline Resource (ベースライン リソースに照らして検証する) |
新しいバージョンのマニフェストを作るときに、-s オプションを使って作ったベースラインに照らしてそのアプリケーションの互換性を確認するには、この引数を使います。 |
詳細 |
詳しい出力を生成するには、このオプションを使います。(-v) |
関連トピック
メッセージ コンパイラ タスク