!wmitrace.searchpath

L'estensione !wmitrace.searchpath specifica il percorso dei file di formato del messaggio di traccia per i messaggi nei buffer di traccia.

!wmitrace.searchpath [+] TMFPath 
!wmitrace.searchpath

Parametri

+
Fa sì che TMFPath venga aggiunto al percorso di ricerca esistente. Se il token più (+) non viene usato, TMFPath sostituisce il percorso di ricerca esistente.

TMFPath
Percorso della directory in cui il debugger deve cercare i file di formato del messaggio di traccia. I percorsi che contengono spazi non sono supportati. Se sono inclusi più percorsi, devono essere separati da punti e virgola e l'intera stringa deve essere racchiusa tra virgolette. Se il percorso è tra virgolette, il carattere barra rovesciata deve essere preceduto da un carattere di escape ( "c:\\debuggers;c:\\debuggers2" ). Quando si usa il + token, TMFPath verrà aggiunto al percorso esistente, con un punto e virgola inserito automaticamente tra il percorso esistente e il nuovo percorso. Tuttavia, se viene usato il + token, non è possibile usare le virgolette.

DLL

Wmitrace.dll

Questa estensione è disponibile in Windows 2000 e versioni successive di Windows. Se vuoi usare questa estensione con Windows 2000, devi prima copiare il file Wmitrace.dll dalla sottodirectory winxp della directory di installazione strumenti di debug per Windows nella sottodirectory w2kfre.

Informazioni aggiuntive

Per una panoramica concettuale della traccia degli eventi, vedere Microsoft Windows SDK. Per informazioni sui file di formato dei messaggi di traccia, vedere l'argomento "File di formato messaggio di traccia" in Windows Driver Kit (WDK).

Osservazioni:

Se usato senza parametri, !wmitrace.searchpath visualizza il percorso di ricerca corrente.

I file di formato dei messaggi di traccia (*.tmf) contengono istruzioni per la formattazione dei messaggi di traccia binari generati da un provider di traccia.

Il parametro TMFPath deve contenere solo un percorso di una directory. Non può includere un nome di file. Il nome di un file TMF è un GUID del messaggio seguito dall'estensione tmf. Quando il sistema formatta un messaggio, legge il GUID del messaggio nel messaggio e cerca in modo ricorsivo un file TMF il cui nome corrisponde al GUID del messaggio, a partire dalla directory specificata.

Windows richiede un file TMF per formattare i messaggi di traccia binari in un buffer. Usare !wmitrace.searchpath o !wmitrace.tmffile per specificare il file TMF prima di usare !wmitrace.dynamicprint o !wmitrace.logdump per visualizzare il contenuto del buffer di traccia.

Se non si utilizza !wmitrace.searchpath o !wmitrace.tmffile, il sistema usa il valore della variabile di ambiente TRACE_FORMAT_SEARCH_PATH. Se tale variabile non è presente, usa il file default.tmf, incluso in Windows. Se il sistema non riesce a trovare informazioni di formattazione per un messaggio di traccia, scrive un messaggio di errore "Nessuna informazione di formato trovato" al posto del contenuto del messaggio di traccia.