Přidání maker WPP do zprostředkovatele trasování

Chcete-li přidat výchozí způsob trasování pomocí softwaru WPP do zprostředkovatele trasování, jako je ovladač režimu jádra nebo aplikace v uživatelském režimu, přidejte následující C direktivy preprocesoru a volání makro instrukcí WPP do zdrojového kódu zprostředkovatele:

• Direktiva #include následujícího formuláře pro každý zdrojový soubor, který obsahuje všechna makra WPP. Tento příkaz obsahuje soubor hlavičky trasovací zprávy vytvořený preprocesorem WPP pro každý zdrojový soubor:

  #include <source-file-name.tmh>
  

  Soubor záhlaví zprávy trasování musí být součástí zdrojového souboru před všemi WPP makry voláními a po definování makra WPP_CONTROL_GUIDS.

• Direktiva definice WPP_CONTROL_GUIDS pro každý zdrojový soubor, který obsahuje další makra WPP.

  Tato definice určuje identifikátor GUID ovládacího prvku ovladače a názvy příznaků trasování definované ovladačem. Definice musí být přidána do zdrojového souboru před #include, který zahrnuje trasovací hlavičkový soubor daného souboru.

• Jedno makrovolání WPP_INIT_TRACING ve zdrojovém kódu ovladače.

  U ovladačů toto makro aktivuje trasování softwaru v ovladači. Toto makro se obvykle volá během inicializace ovladačů, například v rutině DriverEntry .

  Pro aplikace v uživatelském režimu volejte toto makro v okamžiku ve zdrojovém kódu, kde nebyly dříve provedeny žádné pokusy o trasování.

  Po inicializaci můžete pomocí TraceView nebo Tracelogu spustit relaci trasování softwaru a zobrazit zprávy trasování.

• Jedno volání makra WPP_CLEANUP do zdrojového kódu zprostředkovatele trasování. Toto makro deaktivuje trasování softwaru v ovladači.

  Pro ovladače je toto volání makra obvykle přidáno do procedury Unload ovladače.

  Pro aplikace v uživatelském režimu zavolejte toto makro v okamžiku ve zdrojovém kódu po posledním pokusu o trasování.

• Volání makra DoTraceMessage pro protokolování trasovacích zpráv.