Tracepdb — omówienie

Dostawcy śledzenia, tacy jak aplikacje w trybie użytkownika i sterowniki trybu jądra, przechowują komunikaty śledzenia w postaci binarnej w celu zwiększenia wydajności. Aby odczytać komunikaty śledzenia, należy zastosować instrukcje formatowania określone dla każdego komunikatu śledzenia w kodzie dostawcy śledzenia.

Preprocesor WPP wyodrębnia instrukcje formatowania z kodu dostawcy śledzenia i dodaje je do plików symboli PDB dostawcy śledzenia.

Tracepdb wyodrębnia instrukcje formatowania z pełnych lub prywatnych wersji pliku symboli PDB dla dostawcy śledzenia (instrukcje formatowania śledzenia są usuwane z publicznych plików symboli). Tworzy pliki formatu komunikatów śledzenia (tmf) dla każdego dostawcy śledzenia w kodzie źródłowym. Pliki TMF to pliki tekstowe zawierające tylko instrukcje formatowania komunikatów śledzenia dostawcy.

Narzędzia, które wyświetlają komunikaty śledzenia w formacie czytelnym, takim jak TraceView i Tracefmt, używają plików TMF do analizowania i formatowania komunikatów śledzenia. Ponadto można dystrybuować pliki TMF do użytkowników, zamiast rozpowszechniać prywatne pliki symboli.

Tracepdb tworzy plik MOF (.mof), który zawiera GUID kontrolny i poziomy śledzenia każdego dostawcy śledzenia, reprezentowane w pliku PDB. Nazwa pliku MOF to nazwa modułu dostawcy śledzenia.

Usługa Tracepdb może również utworzyć plik kontroli komunikatów śledzenia (tmc) dla każdego dostawcy śledzenia w kodzie źródłowym, jeśli używasz opcji -c . Plik TMC zawiera identyfikator GUID kontrolki i poziomy śledzenia każdego dostawcy śledzenia reprezentowane w pliku PDB. Nazwa pliku TMC to identyfikator GUID kontrolki dostawcy śledzenia. Należy zadbać tylko o plik TMC, jeśli będziesz używać funkcji Traceview bez pliku PDB.

Jedyną funkcją tracepdb jest utworzenie plików TMF. Jednak inne narzędzia, takie jak BinPlace, TraceView i Tracefmt, tworzą pliki TMF oprócz innych funkcji. Użycie narzędzia Tracepdb jest równoważne użyciu polecenia binplace -:tmf, polecenia traceview -parsepdb oraz polecenia tracefmt -i.

W systemach wcześniejszych niż Windows Vista usługa Tracepdb wymaga mspdb70.dll i msvcr70.dll. Jeśli te pliki nie znajdują się w tym samym katalogu co plik Tracepdb.exe, przenieś je przed użyciem usługi Tracepdb.

W systemach wcześniejszych niż Windows Vista należy skopiować plik Dbghelp.dll z podkatalogu bin\<Platform> zestawu Windows Driver Kit (WDK) (gdzie <platforma>jest x86, amd64 lub ia64) do katalogu, w którym znajduje się Tracefmt.exe.

Aby uzyskać więcej informacji na temat śledzenia zdarzeń, zobacz dokumentację zestawu Windows SDK. Aby uzyskać informacje o używaniu śledzenia zdarzeń w sterownikach trybu jądra i aplikacjach trybu użytkownika, zobacz Śledzenie oprogramowania WPP.