Trasování softwaru WPP

Tato část popisuje, jak pomocí preprocesoru trasování softwaru systému Windows (WPP) sledovat provoz softwarové komponenty (zprostředkovatel trasování). Zprostředkovatel trasování může být jeden z následujících:

• Ovladač režimu jádra.

• Ovladač v uživatelském režimu, aplikace nebo dynamická knihovna (DLL).

Vylepšuje trasování softwaru WPP tím, že dodává trasování událostí rozhraní WMI způsoby, jak zjednodušit trasování operací poskytovatele trasování. Je to účinný mechanismus, který umožňuje poskytovateli trasování protokolovat binární zprávy v reálném čase. Protokolované zprávy lze následně převést na čitelné trasování operace zprostředkovatele trasování.

Kdy byste měli použít trasování softwaru WPP?

Trasování softwaru WPP je primárně určené pro ladění kódu během vývoje. Pokud chcete publikovat události, které mohou využívat aplikace zajímající se o strukturované události trasování událostí systému ETW, použijte kromě trasování během vývoje následující: U ovladačů v režimu jádra použijte rozhraní API trasování událostí pro Windows (ETW ). Pro ovladače nebo aplikace v uživatelském režimu použijte rozhraní API pro trasování událostí (Windows Desktop). Další informace najdete v tématu Kdy mám použít trasování softwaru WPP nebo rozhraní API trasování událostí pro Windows (ETW)?

Protokolování zpráv prostřednictvím trasování softwaru WPP je podobné použití služby protokolování událostí systému Windows. Ovladač zaznamená ID zprávy a neformátovaná binární data v souboru protokolu. Následně postprocesor převede informace v souboru protokolu na čitelný formulář pro člověka. Trasování softwaru WPP ale podporuje formáty zpráv, které jsou schopny a flexibilnější než služby protokolování událostí. Například trasování softwaru WPP má integrovanou podporu IP adres, identifikátorů GUID, systémových ID, časových razítek a dalších užitečných datových typů. Uživatelé navíc můžou přidat vlastní datové typy, které jsou pro svou aplikaci relevantní.

Přehled procesu trasování softwaru WPP

Základní postup přidání trasování softwaru WPP do ovladače nebo aplikace zahrnuje následující kroky. Pokud k vytvoření ovladače WDF použijete některou ze šablon sady Visual Studio, která je součástí WDK, provede se za vás velká část práce.

• Definujte GUID ovládacího prvku, který jednoznačně identifikuje ovladač nebo aplikaci jako zprostředkovatele trasování. Zprostředkovatel určuje tento identifikátor GUID v definici makra WPP_CONTROL_GUIDS a v souvisejícím řídicím souboru používaném tracelogem nebo jiným kontrolerem trasování.

• Přidejte požadované direktivy preprocesoru související s WPP a volání maker WPP do zdrojových souborů poskytovatele, jak je popsáno v tématu Přidání trasování softwaru WPP do ovladače systému Windows a v referenční dokumentaci k trasování softwaru WPP.

• Upravte projekt sady Visual Studio tak, aby spustil preprocesor WPP a sestavte ovladač, jak je popsáno v kroku 6 přidání trasování softwaru WPP do ovladače systému Windows. Další možnosti doby sestavení můžete najít v Preprocesoru WPP.

• Nainstalujte ovladač nebo součást. Spusťte relaci trasování a zaznamenejte si zprávy trasování. Pomocí nástrojů pro trasování softwaru, jako jsou TraceView, Tracelog, Tracefmt a Tracepdb , můžete konfigurovat, spouštět a zastavovat trasovací relace a zobrazovat a filtrovat zprávy trasování. Tyto nástroje jsou součástí sady Windows Driver Kit (WDK).

V této části

• Přidání trasování softwaru WPP do ovladače systému Windows
• Letový trasovací zapisovač pro záznam tras
• Použití trasování softwaru WPP v poskytovateli trasování
• Přidání maker WPP do trasovacího zprostředkovatele
• Preprocesor WPP
• Trasování a diagnostika pro ovladače WDF

Poznámka Trasování událostí pro Windows (ETW) a WPP podporují většinu typů ovladačů režimu jádra a uživatelského režimu. EtW a WPP však používají typy, které nejsou k dispozici pro určité typy ovladačů, jako jsou ovladače miniportu. Chcete-li zjistit, zda je podporován konkrétní typ ovladače, přidejte do ovladače základní makra WPP, například WPP_INIT_TRACING a WPP_CLEANUP. Pokud se kód nekompiluje, protože použité typy nejsou definovány, etW a WPP nemůžou podporovat typ ovladače.

Další informace o trasování událostí pro Windows naleznete v tématu Trasování událostí pro Windows.

Poznámka Zprostředkovatele trasování WPP lze povolit pouze jednou trasovací relací najednou. Další informace najdete v tématu Poskytovatelé WPP .

Informace o podporujících rutinách knihovny WMI, které podporují trasování softwaru WPP, viz:

WmiQueryTraceInformation

WmiTraceMessage

WmiTraceMessageVa