Plik formatu komunikatu śledzenia

Plik formatu komunikatu śledzenia (TMF) to plik tekstowy ze strukturą, który zawiera instrukcje dotyczące analizowania i formatowania binarnych komunikatów śledzenia generowanych przez dostawcę śledzenia . Instrukcje formatowania są zawarte w kodzie źródłowym dostawcy śledzenia i są dodawane do pliku symboli PDB dostawcy śledzenia przez preprocesor WPP.

Niektóre narzędzia, które rejestrują i wyświetlają sformatowane komunikaty śledzenia, wymagają pliku TMF. Tracefmt i TraceView, narzędzia WDK, które formatują i wyświetlają komunikaty śledzenia, mogą używać pliku TMF lub wyodrębniać informacje o formatowaniu bezpośrednio z pliku symboli PDB.

Plik TMF można utworzyć przy użyciu narzędzia Tracefmt i w tym parametru -i , który przekierowuje narzędzie Tracefmt do utworzenia pliku TMF dla tracedrv. Aby uzyskać więcej informacji, zobacz Przykład 9: Tworzenie pliku TMF.

Jeśli nie masz pliku TMF dla dostawcy śledzenia, użyj usługi Tracepdb. Tracepdb wyodrębnia instrukcje formatowania z pliku symboli PDB i tworzy plik TMF do ich przechowywania. Wielu deweloperów aplikacji i sterowników preferuje wysyłanie pliku TMF, a nie pliku symboli PDB.

Nazwa pliku TMF to identyfikator GUID komunikatów skojarzonych z tym plikiem TMF. ETW używa identyfikatora GUID komunikatu do skojarzenia określonych komunikatów śledzenia z plikiem TMF, który przechowuje instrukcje formatujące.

Plik TMF zawiera następujące dane:

• Nazwa pliku PDB, z którego wyodrębniono dane pliku TMF.

• Identyfikator GUID komunikatów śledzenia w pliku źródłowym o nazwie pliku źródłowego.

• Dla każdego komunikatu śledzenia wpis określający typ komunikatu, nazwę pliku kodu źródłowego, numer wiersza, numer komunikatu, ciąg definicji komunikatu, nazwę flagi śledzenia i nazwę funkcji C, która zawiera wywołanie makra.

• Lista zmiennych, których wartości są wyświetlane w komunikatach śledzenia i skojarzonych z nimi nazwach typów wewnętrznych. Zmienne są reprezentowane przez notację %n w ciągu definicji komunikatu.

Nuta Plik TMF jest zarezerwowany do użytku wewnętrznego, a jego format podlega zmianie między różnymi wersjami systemu Windows.