次の方法で共有

Ctrpp タスク

  • [アーティクル]

Windows Driver Kit (WDK) には Ctrpp タスクが用意されているため、MSBuild を使用してドライバーをビルドするときに ctrpp.exe ツールを実行できます。 ctrpp.exeの使用については、CTRPP を参照してください 。

MSBuild では、Ctrpp を使用して Ctrpp タスクのパラメーターを ctrpp.exe 送信します。 プロジェクト ファイル内の Ctrpp 項目は、ctrpp.exe の項目メタデータにアクセスします。

次の例は、.vcxproj ファイル内のメタデータを編集する方法を示しています。

<ItemGroup>
    <Ctrpp Include="a.manifest">
      <GenerateHeaderFileForCounter>true</GenerateHeaderFileForCounter>
      <HeaderFileNameForCounter>c:\test\abc.h</HeaderFileNameForCounter>
    </Ctrpp>
</ItemGroup>

コマンド ライン呼び出しの例を次に示します。

ctrpp.exe –ch "c:\test\abc.h" a.manifest

上の例では、メタデータ GenerateHeaderFileForCounter が true に設定されているため、MSBuild はファイル a.manifest で ctrpp.exeを呼び出し、 –ch オプションを指定します。 また、MSBuild では HeaderFileNameForCounter メタデータを使用して、–ch オプションの引数を 指定します。

Ctrpp タスク パラメーター 項目メタデータ ツール スイッチ 説明
ソース @(Ctrpp) 必須の ITaskItem 型のパラメーターです。 処理するカウンター マニフェストを指定します。
AddPrefix %(Ctrpp.AddPrefix) -prefix<prefix> 省略可能な string 型のパラメーターです。 生成される関数と変数に追加するプレフィックスを指定します。
BackwardCompatibility %(Ctrpp.BackwardCompatibility) -backcompat 省略可能な Boolean 型のパラメーターです。 Windows 7 より前のオペレーティング システムとバイナリ互換性のあるコードを生成します。
EnableLegacy %(Ctrpp.EnableLegacy) -レガシー 省略可能な Boolean 型のパラメーターです。 以前の ctrpp ファイルに戻ります。 このスイッチを指定すると、ctrpp によって 4 つの出力ファイル (2 つのヘッダー ファイル、1 つのリソース ファイル、1 つのソース コード ファイル が生成されます。 これは、以前のバージョンの ctrpp で見つかった動作を模倣します。 -o、-ch、-rc、-prefix の各オプションを -legacy と組み合わせて使用することはできません。
GeneratedCounterFilesPath %(Ctrpp.GeneratedCounterFilesPath) -sumPath<path> 省略可能な string 型のパラメーターです。 バイナリ カウンター ファイルのデフォルトを生成するパスを指定します。
GenerateHeaderFileForCounter %(Ctrpp.GenerateHeaderFileForCounter) これを true に設定すると、-ch スイッチが有効になります。
HeaderFileNameForCounter %(Ctrpp.HeaderFileNameForCounter) -ch<filename> 省略可能な string 型のパラメーターです。 カウンター名と ID を含むヘッダー ファイルを生成します。
GenerateHeaderFileForProvider %(Ctrpp.GenerateHeaderFileForProvider) これを true に設定すると、-o スイッチが有効になります。
HeaderFileNameForProvider %(Ctrpp.HeaderFileNameForProvider) -o<filename> 省略可能な string 型のパラメーターです。 プロバイダーのヘッダー ファイルを生成する。
GenerateMemoryRoutines %(Ctrpp.GenerateMemoryRoutines) (-メモリルーチン 省略可能な Boolean 型のパラメーターです。 メモリ割り当ておよび解放ルーチン テンプレートを生成します。
GenerateNotificationCallback %(Ctrpp.GenerateNotificationCallback) -通知コールバック 省略可能な Boolean 型のパラメーターです。 カスタマイズされた通知コールバック テンプレートを生成します。 プロバイダー <要素の "callback" 属性に> 似ています。
GenerateResourceSourceFile %(Ctrpp.GenerateResourceSourceFile) これを true に設定すると、rc スイッチが有効になります。
ResourceFileName %(Ctrpp.ResourceFileName) -rc<filename> 省略可能な string 型のパラメーターです。 リソース ソース ファイルを生成します。
GenerateSummaryGlobalFile %(Ctrpp.GeneratedSummaryGlobalFile) -summary<path> 省略可能な string 型のパラメーターです。 プロバイダーごとにバイナリ カウンター ファイルを生成し、概要グローバル ファイル GenSumResource.BIN を生成します。

CTRPP