Lägga till WPP-makron i en spårningsleverantör

Om du vill lägga till standardformuläret för WPP-programspårning till en spårningsprovider, till exempel en drivrutin i kernelläge eller ett program i användarläge, lägger du till följande C-förprocessordirektiv och WPP-makroanrop till providerns källkod:

• Ett #include-direktiv av följande form för varje källfil som innehåller några WPP-makron. Den här instruktionen innehåller huvudfilen för spårningsmeddelandet som skapats av WPP-förprocessorn för varje källfil:

  #include <source-file-name.tmh>
  

  Huvudfilen för spårningsmeddelandet måste inkluderas i en källfil innan något WPP-makro anropas och när du har definierat ett WPP_CONTROL_GUIDS makro.

• Ett WPP_CONTROL_GUIDS definitionsdirektiv för varje källfil som innehåller andra WPP-makron.

  Den här definitionen anger drivrutinens kontroll-GUID och de drivrutinsdefinierade spårningsflagganamnen. Definitionen måste läggas till i en källfil innan #include-instruktionen som innehåller filens rubrikfil för spårningsmeddelande.

• Ett WPP_INIT_TRACING makroanrop till drivrutinens källkod.

  För drivrutiner aktiverar det här makrot spårning av programvara i drivrutinen. Det här makrot anropas vanligtvis under drivrutinsinitieringen, till exempel i en DriverEntry-rutin .

  För program i användarläge anropar du det här makrot vid en punkt i källkoden där inga spårningsförsök har gjorts tidigare.

  Efter initieringen kan du använda TraceView eller Tracelog för att starta en programspårningssession och visa spårningsmeddelanden.

• Ett WPP_CLEANUP makroanrop till spårningsproviderns källkod. Det här makrot inaktiverar spårning av programvara i drivrutinen.

  För drivrutiner läggs det här makroanropet vanligtvis till i drivrutinens avlastningsrutin .

  För program i användarläge anropar du det här makrot vid en tidpunkt i källkoden när de senaste spårningsförsöken har gjorts.

• DoTraceMessage-makroanrop för att logga spårningsmeddelanden .