Condividi tramite

Uso della traccia software WPP nei driver KMDF

  • Articolo

La traccia software WPP consente di aggiungere messaggi di traccia che consentono di eseguire il debug del driver. Inoltre, il logger di eventi del framework offre centinaia di messaggi di traccia che è possibile visualizzare.

È possibile visualizzare i messaggi di traccia usando TraceView o Tracelog. È anche possibile inviare messaggi di traccia a un debugger del kernel.

Aggiunta di messaggi di traccia al driver

Per aggiungere messaggi di traccia al driver basato su framework, è necessario:

  • Aggiungere una direttiva #include a ogni file di origine del driver che contiene una delle macro WPP. Questa direttiva deve identificare un file di intestazione del messaggio di traccia (TMH). Il nome del file deve avere un formato di <driver-source-file-name.tmh.>

    Ad esempio, se il driver è costituito da due file di origine, denominato MyDriver1.c e MyDriver2.c, MyDriver1.c deve contenere:

    #include "MyDriver1.tmh"

    e MyDriver2.c devono contenere:

    #include "MyDriver2.tmh"

    Quando si compila il driver in Microsoft Visual Studio, il preprocessore WPP genera l'oggetto . file tmh .

  • Definire una macro WPP_CONTROL_GUIDS in un file di intestazione. Questa macro definisce un GUID e flag di traccia per i messaggi di traccia del driver.

  • Includere una macro WPP_INIT_TRACING nella routine DriverEntry del driver. Questa macro attiva la traccia software nel driver.

  • Includere una macro WPP_CLEANUP nella funzione di callback EvtDriverUnload del driver. Questa macro disattiva la traccia software nel driver.

  • Usare la macro DoTraceMessage o una versione personalizzata della macro nel driver per creare messaggi di traccia.

  • Aprire le pagine delle proprietà per il progetto driver. Fare clic con il pulsante destro del mouse sul progetto driver in Solution Explorer e selezionare Proprietà. Nelle pagine delle proprietà per il driver fare clic su Proprietà di configurazione e quindi su Wpp Tracing. Nel menu Generale impostare Esegui traccia WPP su Sì. Nel menu Opzioni file è necessario specificare anche il file di modello WPP del framework, ad esempio:

    {km-WdfDefault.tpl}*.tmh

  • Per specificare altre impostazioni di traccia WPP per il progetto driver in Visual Studio, fare clic con il pulsante destro del mouse sul progetto driver in Esplora soluzioni. Seguire quindi il collegamento a Proprietà-Configurazione proprietà-WPP>> Tracing.

  • Per specificare un file di configurazione di traccia, usare l'impostazione "Analizza dati di configurazione". Per più di un file di configurazione di traccia aggiungerlo nella riga di comando'-> 'Opzioni aggiuntive' come indicato di seguito

    -scan:"$(KMDF_INC_PATH)\$(KMDF_VER_PATH)\wdftraceenums.h"

    Per altre informazioni sull'aggiunta di messaggi di traccia al driver, vedere Aggiunta di macro WPP a un driver.

Driver di esempio che usano la traccia software WPP

I driver di esempio AMCC593, NONPNP, KMDF_FX2, PCIDRV, PLX9x5x e Serial sample usano la traccia software WPP.