Textové protokoly SetupAPI

In Windows Vista and later versions of Windows, SetupAPI supports a device installation text log (SetupAPI.dev.log) and an application installation text log (SetupAPI.app.log). Správce plug and play (PnP) a položky zápisu SetupAPI do protokolu textu instalace zařízení za účelem poskytnutí informací o operacích, které instalují zařízení a ovladače. Správce PnP a položky zápisu SetupAPI do protokolu textu instalace aplikace, který poskytuje informace o instalačních operacích kromě těch, které se týkají konkrétně instalace zařízení a ovladačů.

Instalační aplikace, instalační programy tříd a spolu installery můžou používat funkce protokolování SetupAPI k zápisu položek do protokolu instalace zařízení a protokolu textu instalace aplikace.

The SetupAPI text logs are ANSI plain text files, which are located by default in the %SystemRoot%\inf directory. Textové protokoly jsou v anglickém (standardním) jazyce.

Textové protokoly SetupAPI mají následující interní formát:

• A log entry is one line in a text log.

• Prvních několik položek protokolu poskytuje hlavičku textového protokolu , která obsahuje informace o operačním systému a architektuře počítače. Další informace naleznete v tématu Formát záhlaví textového protokolu.

• Za záhlavím textového protokolu je nula nebo více oddílů textového protokolu. Každý oddíl textového protokolu zaznamenává události během instalace jednoho zařízení.

  Účelem oddílu textového protokolu je seskupit a naformátovat souvislou sekvenci položek protokolu, které poskytují informace o konkrétní operaci instalace. Vytvořením oddílů textového protokolu může správce PnP, SetupAPI nebo vlastní instalační aplikace uspořádat položky protokolu koncepčním smysluplným způsobem. Správce PnP může například vytvořit oddíl textového protokolu, který seskupí všechny položky protokolu, které platí pro instalaci zařízení. Oddíly textového protokolu se zobrazí v textovém protokolu v pořadí, ve kterém jsou vytvořeny. Další informace naleznete v tématu Formát oddílu textového protokolu.

• Textový protokol může obsahovat položky protokolu, které nejsou součástí záhlaví textového protokolu nebo oddílu textového protokolu. Tyto položky jsou přidruženy k operacím, které nejsou součástí žádného konkrétního oddílu textového protokolu, a obecně jsou interspersed mezi oddíly textového protokolu. Položky protokolu, které nejsou součástí oddílu textového protokolu, se zobrazují v protokolu ve stejném pořadí, v jakém jsou zapsány do textového protokolu. Další informace o těchto položkách protokolu naleznete v tématu Formát položek protokolu, které nejsou součástí oddílu textového protokolu.