Edit

SetupAPI Text Logs

  • Article

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). The Plug and Play (PnP) manager and SetupAPI write entries to the device installation text log to provide information about operations that install devices and drivers. The PnP manager and SetupAPI write entries to the application installation text log that provide information about installation operations other than those that pertain specifically to device and driver installations.

Installation applications, class installers, and co-installers can use the SetupAPI logging functions to write entries to the device installation log and the application installation text log.

The SetupAPI text logs are ANSI plain text files, which are located by default in the %SystemRoot%\inf directory. The text logs are in the English (Standard) language.

The SetupAPI text logs have the following internal format:

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

  • The first few log entries provide a text log header that contains information about the operating system and computer architecture. For more information, see Format of a Text Log Header.

  • Following the text log header are zero or more text log sections. Each text log section records the events during a single device installation.

    The purpose of a text log section is to group and format a contiguous sequence of log entries that provide information about a particular installation operation. By creating text log sections, the PnP manager, SetupAPI, or a custom installation application can organize log entries in a conceptually meaningful way. For example, the PnP manager might create a text log section to group all log entries that apply to installing a device. Text log sections appear in a text log in the order in which they are created. For more information, see Format of a Text Log Section.

  • A text log can contain log entries that are not part of the text log header or a text log section. Such entries are associated with operations that are not part of any particular text log section and, in general, are interspersed between text log sections. Log entries that are not part of a text log section appear in the log in the same order in which they are written to the text log. For more information about such log entries, see Format of Log Entries That Are Not Part of a Text Log Section.