Co jsou řetězce specifikace rozšířeného formátu WPP

WPP obsahuje předdefinované řetězce specifikace formátu, které můžete použít v trasovacích zprávách kromě standardních formátovacích řetězců definovaných pro printf.

Můžete použít %!FLAGS!, %!FUNC! a %!LEVEL! řetězce v předponě zprávy trasování a v libovolné funkci nebo makru trasování, například DoTraceMessage.

Ostatní rozšířené řetězce můžete použít v libovolné funkci trasování.

Výchozí možnosti konfigurace pro tracewpp

WPP používá pro výchozí nastavení konfiguracedefaultwpp.ini. Tento výchozí soubor INI je součástí sady Windows SDK v adresáři WppConfig Rev1. Nejnovější informace o výchozím chování WPP a další informace o přizpůsobení najdete v tomto souboru INI.

Trasování softwaru

Formát řetězce	Popis
%!SOUBOR!	Zobrazí název zdrojového souboru, ze kterého se vygenerovala zpráva trasování. Tuto proměnnou lze použít také v předponě zprávy trasování.
%! VLAJKY!	Zobrazí hodnotu příznaků trasování, které umožňují vytvoření zprávy trasování. Tuto proměnnou lze také použít v předponě trasovací zprávy.
%! FUNC!	Zobrazí funkci, která vygenerovala zprávu trasování. Tuto proměnnou lze použít také v předponě trasovací zprávy.
%! ÚROVEŇ!	Zobrazí název úrovně trasování , která umožňuje zprávu trasování. Tuto proměnnou lze použít také v předponě zprávy trasování.
%!LINE!	Zobrazí číslo řádku v kódu, který vygeneroval předponu trasování. Tuto proměnnou lze také použít v předponě sledovací zprávy.

Obecné použití

Formát řetězce	Popis
%!bool!	Zobrazí hodnotu PRAVDA nebo NEPRAVDA.
%!irql!	Zobrazí název aktuálního IRQL.
%!sid!	Představuje ukazatel na identifikátor zabezpečení (pSID). Zobrazí identifikátor SID.
GUID
%!GUID!	Představuje ukazatel na identifikátor GUID (pGUID). Zobrazí GUID, na který je právě ukazováno.
%!CLSID!	ID třídy. Představuje ukazatel na GUID identifikátor třídy. Zobrazí řetězec přidružený k identifikátoru GUID. WPP vyhledá řetězec v registru, když formátuje zprávy trasování.
%! LIBID!	Knihovna typů Představuje identifikátor GUID knihovny typů COM. Zobrazí řetězec přidružený k identifikátoru GUID. WPP vyhledá řetězec v registru, když formátuje zprávy trasování.
%!IID!	ID rozhraní. Představuje ukazatel na GUID identifikátoru rozhraní. Zobrazí řetězec přidružený k identifikátoru GUID. WPP při formátování trasovacích zpráv vyhledá řetězec v registru.
Time
%!delta!	Zobrazí rozdíl mezi dvěma časovými hodnotami v milisekundách. Jedná se o hodnotu LONGLONG zobrazenou ve formátu den~h:m:s.
%!ČEKACÍ DOBA!	Zobrazí čas strávený čekáním na dokončení něčeho v milisekundách. Jedná se o hodnotu LONGLONG zobrazenou ve formátu „den~h:m:s“. Navrženo pro použití s %!due!.
%!due!	Zobrazí čas dokončení něčeho v milisekundách. Jedná se o hodnotu LONGLONG zobrazenou ve formátu den~h:m:s. Navrženo pro použití s %! WAITTIME!.
%!ČASOVÁ ZNAČKA! %!datetime! %!ČAS!	Zobrazí hodnotu systémového času v určitém okamžiku. Jedná se o hodnoty LONGLONG (SINT64), které se zobrazují ve formátu SYSTEMTIME. Tyto proměnné můžete použít k reprezentaci různých časových hodnot v programu a k rozlišení mezi nimi.

Návratové kódy

Formát řetězce	Popis
%! STAV!	Představuje stavovou hodnotu a zobrazí řetězec přidružený ke stavovém kódu.
%! WINERROR!	Představuje kód chyby systému Windows a zobrazí řetězec přidružený k chybě.
%! HRESULT!	Představuje chybu nebo upozornění a zobrazí kód ve formátu HRESULT.

Síť

Formát řetězce	Popis
%! IPADDR!	Představuje ukazatel na IP adresu. Zobrazí IP adresu.
%! PŘÍSTAV!	Zobrazí číslo portu.