Příklad 7: Přizpůsobení předpony zprávy trasování

Každá zpráva trasování začíná předponou zprávy trasování složenou z dat o zprávě trasování. Formát předpony trasovací zprávy je uložen v proměnné prostředí %TRACE_FORMAT_PREFIX%. Změnou hodnoty proměnné prostředí můžete přizpůsobit předponu zprávy trasování tak, aby zobrazovala data, která potřebujete o zprávě trasování ve formátu, který je pro vás nejužitečnější. Proměnné ve výchozí předponě zprávy trasování a všechny proměnné, které můžete použít v předponě zprávy trasování, jsou popsány v tématu Předpona zprávy trasování.

Displej níže ukazuje výchozí předponu trasovací zprávy. Zprávy trasování byly generovány programem Tracedrv, což je vzorový ovladač s podporou trasování v sadě Windows Driver Kit (WDK).

[0]0AF4.0C64::07/25/2003-14:55:39.998 [tracedrv]IOCTL = 1
[0]0AF4.0C64::07/25/2003-14:55:39.998 [tracedrv]Hello, 1 Hi
[0]0AF4.0C64::07/25/2003-14:55:39.998 [tracedrv]Hello, 2 Hi
...

Formát výchozí předpony je následující.

[%9!d!]%8!04X!.%3!04X!::%4!s! [%1!s!]

představuje následující data:

[CPUNumber]ProcessID.ThreadID::SystemTime [MessageGUIDFriendlyName]

kde MessageGUIDFriendlyName je ve výchozím nastavení název adresáře, ve kterém byl vytvořen zprostředkovatel trasování.

Pokud chcete vytvořit novou předponu zprávy trasování, pomocí příkazu set resetujte hodnotu proměnné prostředí %TRACE_FORMAT_PREFIX%. Příklad:

set TRACE_FORMAT_PREFIX=%2!s!: %!FUNC!: %8!04x!.%3!04x!: %4!s!:

Tento příkaz nastaví předponu zprávy trasování v následujícím formátu:

SourceFile_LineNumber: FunctionName: ProcessID.ThreadID: SystemTime 

Výsledkem je, že výstup Tracefmt používá novou předponu zprávy trasování, jak je znázorněno na následujícím zobrazení:

tracedrv_c258: TracedrvDispatchDeviceControl: 0af4.0c64: 07/25/2003-13:55:39.998:  IOCTL = 1
tracedrv_c264: TracedrvDispatchDeviceControl: 0af4.0c64: 07/25/2003-13:55:39.998:  Hello, 1 Hi
tracedrv_c264: TracedrvDispatchDeviceControl: 0af4.0c64: 07/25/2003-13:55:39.998:  Hello, 2 Hi
tracedrv_c264: TracedrvDispatchDeviceControl: 0af4.0c64: 07/25/2003-13:55:39.998:  Hello, 3 Hi

...

Poznámka Pokud nastavujete předponu trasování v příkazu nebo dávkovém souboru, kde symbol procenta představuje proměnnou pro parametr příkazového řádku, použijte pro proměnné předpony dva po sobě jdoucí symboly procent. Pokud chcete například zahrnout systémový čas do předpony, zadejte %%4.