TraceWPP タスク

Windows Driver Kit (WDK) には TraceWPP タスクが用意されているため、MSBuild を使用してドライバーをビルドするときに tracewpp.exe ツールを実行できます。 tracewpp.exe ツールは、WPP ソフトウェア トレースを実装するために使用されます。

WppEnabled は、ソース ファイルのトレースを有効にする ClCompile 項目の新しいメタデータです。 Wpp タスクは ClCompile 項目コレクション全体を実行し、WppEnabled メタデータが TRUE に設定されている各項目に対してtracewpp.exeを呼び出します。

WPP タスクは CL タスクと同じ種類の入力ファイル (この場合は .c、.cpp、.h) で実行されるため、WppEnabled メタデータが ClCompile Item に追加されました。

注: tracewpp の項目メタデータには、プロジェクト ファイルの ClCompile 項目を使用してアクセスします。 MSBuild は、TraceWpp 項目をターゲット内で内部的に使用してタスクに渡します。

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

<ItemGroup>
    <ClCompile Include="a.c" />
      <WppEnabled>false</WppEnabled>
    <ClCompile Include="b.c">
        <WppEnabled>true</WppEnabled>
        <WppKernelMode>true</WppKernelMode>
        <WppAdditionalIncludeDirectories>c:\test\</WppAdditionalIncludeDirectories>
    </ClCompile>
    <ClCompile Include="test1.c" />
    <ClCompile Include="test2.c">
        <WppEnabled>true</WppEnabled>
        <WppDllMacro>true</WppDllMacro>
    </ClCompile>
</ItemGroup>

コマンド ライン呼び出しは次のようになります。

tracewpp.exe  km /Ic:\test\b.c
tracewpp.exe  dll test2.c

上記の例は、WppEnabled メタデータがこれらの入力に対して TRUE に設定されているため、MSBuild が b.c と test2.c でのみ tracewpp.exe を呼び出していることを示しています。 また、これら 2 つの入力のメタデータは異なっています。 そのため、これらの入力ではスイッチも異なります。 つまり、各入力を独自のメタデータ セットで呼び出すことができます。

関連トピック

WPP プリプロセッサ

WPP ソフトウェア トレース