Aggiungere le macro WPP a un provider di traccia

Per aggiungere il tracciamento software WPP in forma predefinita a un provider di tracciamento, come un driver in modalità kernel o un'applicazione in modalità utente, aggiungi le seguenti direttive del preprocessore C e le chiamate di macro WPP al codice sorgente del provider:

• Direttiva #include del formato seguente per ogni file di origine contenente le macro WPP. Questa istruzione include il file di intestazione del messaggio di traccia creato dal preprocessore WPP per ogni file di origine:

  #include <source-file-name.tmh>
  

  Il file di intestazione del messaggio di traccia deve essere incluso in un file di origine prima di qualsiasi chiamata di macro WPP e dopo aver definito una macro WPP_CONTROL_GUIDS .

• Direttiva di definizione WPP_CONTROL_GUIDS per ogni file di origine che include altre macro WPP.

  Questa definizione specifica il GUID di controllo del driver e i nomi dei flag di traccia definiti dal driver. La definizione deve essere aggiunta a un file di origine prima dell'istruzione #include che include il file di intestazione del messaggio di traccia del file.

• Una WPP_INIT_TRACING chiamata di macro al codice sorgente del driver.

  Per i conducenti, questa macro attiva la tracciatura software nel driver. Questa macro viene in genere chiamata durante l'inizializzazione del driver, ad esempio in una routine DriverEntry .

  Per le applicazioni in modalità utente, chiamare questa macro in un punto nel codice sorgente in cui non sono stati eseguiti tentativi di traccia in precedenza.

  Dopo l'inizializzazione, è possibile usare TraceView o Tracelog per avviare una sessione di traccia software e visualizzare i messaggi di traccia.

• Una WPP_CLEANUP chiamata di macro al codice sorgente del provider di traccia . Questa macro disattiva la traccia software nel driver.

  Per i driver, questa chiamata di macro viene in genere aggiunta alla routine scaricamento del driver.

  Per le applicazioni in modalità utente, chiamare questa macro in un punto nel codice sorgente dopo l'ultimo tentativo di traccia.

• Le chiamate della macro DoTraceMessage per registrare i messaggi di traccia.