Sdílet prostřednictvím

Jak se přihlásit k globální relaci protokolovacího nástroje

  • Článek

Pomocí následujícího postupu nakonfigurujte ovladač pro záznam do globální trasovací relace Loggeru:

  1. Do kódu ovladače přidejte následující definici. Vložte definici mezi definici WPP_CONTROL_GUIDS makra a příkaz include pro hlavičkový soubor se zprávami trasování.

    #define WPP_GLOBALLOGGER

  2. K konfiguraci relace trasování Global Logger použijte Tracelog. Nejjednodušší příkaz je následující:

    tracelog -start GlobalLogger

    Úplné pokyny, včetně parametrů pro konfiguraci globální relace trasování protokolovacího nástroje, naleznete v tématu Syntaxe příkazu Tracelog a globální relace trasování protokolovacího nástroje.

    Příklad najdete v Příklad 13: Vytvoření globální relace loggeru.

    Tento příkaz vytvoří a nakonfiguruje relaci trasování, ale relace se nespustí, dokud nerestartujete systém (krok 5).

  3. Pod podklíč HKLM\System\CurrentControlSet\Control\WMI\GlobalLogger přidejte podklíč pojmenovaný pro identifikátor GUID ovládacího prvku zprostředkovatele trasování. V systému Windows Vista a novějších verzích systému Windows musí být identifikátor GUID ovládacího prvku uzavřený ve složených závorkách ( {} ).

    Tracelog -start příkaz GlobalLogger přidá do registru podklíč GlobalLogger. Podklíč ControlGUID určuje ovladač jako zprostředkovatele trasování pro relaci trasování Global Logger.

    Pokud chcete například nakonfigurovat ukázkový ovladač Tracedrv, aby protokoloval do relace trasování globálního loggeru v počítači se systémem Windows XP, přidejte podklíč s názvem globálního identifikátoru ovládacího prvku Tracedrv, d58c126f-b309-11d1-969e-0000f875a5bc: HKLM\SYSTEM\CurrentControlSet\Control\WMI\GlobalLogger\d58c126f-b309-11d1-969e-0000f875a5bc.

    TraceDrv, ukázkový ovladač navržený pro trasování softwaru, je k dispozici v úložišti ukázek ovladačů pro Windows na GitHubu.

  4. Chcete-li nakonfigurovat zprostředkovatele trasování, přidejte do podklíče ControlGUID následující položky registru. Tyto položky jsou volitelné a jejich hodnoty jsou definovány ovladačem.

    Název položky Datový typ Popis

    Vlajky

    REG_DWORD

    Určuje sledovací příznaky pro poskytovatele.

    Význam příznaků je definován nezávisle každým poskytovatelem trasování. Vlajky obvykle představují stále podrobnější úrovně zpráv.

    Úroveň

    REG_DWORD

    Určuje úroveň trasování pro poskytovatele.

    Význam hodnoty úrovně je definován nezávisle každým poskytovatelem trasování. Úroveň sledování obvykle představuje závažnost události (informace, upozornění nebo chyba).

Všimněte si, že název položky Flags je v množném čísle a název položky úrovně je v jednotném čísle.

  1. Restartujte systém. Tím se spustí trasovací relace Global Logger.

Po dokončení testování odstraňte podklíč ControlGUID nebo nastavte hodnotu položky Start v podklíči GlobalLogger na hodnotu 0. Pokud tak neučiníte, při každém restartování systému se spustí relace globálního protokolovacího nástroje a ovladač do ní zaznamenává data.

komentáře k

Při přítomnosti WPP_GLOBALLOGGER přidá WPP kód, který načte registr a určí, zda je spuštěna relace Globálního Loggeru a zda je ovladač povolen pro trasování v této relaci. Tento kód nahrazuje oznámení o povolení, které by ovladač obdržel ze standardní relace trasování.

Vzhledem k tomu, že relace Global Logger neposkytuje oznámení zpětného volání, systém Windows předpokládá, že došlo ke zpětnému volání, a pokračuje odpovídajícím způsobem.

Definice WPP generují pouze malé množství kódu, takže po testování není nutné je z kódu odebrat.