TraceWPP task

Zestaw Sterowników systemu Windows (WDK) udostępnia zadanie TraceWPP, aby można było uruchomić narzędzie tracewpp.exe podczas kompilowanie sterownika przy użyciu programu MSBuild. Narzędzie tracewpp.exe służy do implementowania śledzenia oprogramowania WPP.

WppEnabled to nowe metadane elementu ClCompile, które umożliwiają śledzenie plików źródłowych. The Wpp task runs through the entire ClCompile Item Collections and invokes tracewpp.exe for each Item for which the WppEnabled metadata is set to TRUE.

Metadane WppEnabled zostały dodane do elementu ClCompile, ponieważ zadanie WPP jest uruchamiane na tym samym typie plików wejściowych co zadanie CL, w tym przypadku .c, .cpp i .h plików.

Note You access the Item metadata for tracewpp by using the ClCompile item in project files. Program MSBuild używa elementu TraceWpp wewnętrznie wewnątrz obiektu docelowego, aby przekazać go do zadania.

W poniższym przykładzie pokazano, jak edytować metadane w pliku .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>

Wywołanie wiersza polecenia będzie następujące:

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

The example above shows that MSBuild invokes tracewpp.exe only on b.c and test2.c because the WppEnabled metadata is set to TRUE for these inputs. Należy również pamiętać, że metadane tych dwóch danych wejściowych są różne. W związku z tym przełączniki będą również inne dla tych danych wejściowych. Innymi słowy, można wywołać każde dane wejściowe przy użyciu własnego zestawu metadanych.

Tematy powiązane

WPP Preprocessor

śledzenie oprogramowania WPP