Текстовые журналы 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). Диспетчер Plug and Play (PnP) и SetupAPI записывают записи в текстовый журнал установки устройства, чтобы предоставить сведения об операциях установки устройств и драйверов. Диспетчер PnP и SetupAPI записывают записи в текстовый журнал установки приложения, предоставляющий сведения об операциях установки, отличных от операций установки, относящихся к установкам устройств и драйверов.

Приложения установки, установщики классов и совместно установщики могут использовать функции ведения журнала SetupAPI для записи записей в журнал установки устройства и текстового журнала установки приложения.

The SetupAPI text logs are ANSI plain text files, which are located by default in the %SystemRoot%\inf directory. Текстовые журналы находятся на английском (стандартном) языке.

Текстовые журналы SetupAPI имеют следующий внутренний формат:

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

• Первые несколько записей журнала предоставляют заголовок текстового журнала , содержащий сведения об операционной системе и архитектуре компьютера. Дополнительные сведения см. в разделе "Формат заголовка текстового журнала".

• После заголовка текстового журнала равно нулю или нескольким разделам текстового журнала. Каждый раздел текстового журнала записывает события во время установки одного устройства.

  Цель раздела текстового журнала — группировать и форматировать последовательную последовательность записей журнала, которые предоставляют сведения о определенной операции установки. Создавая разделы текстового журнала, диспетчер PnP, SetupAPI или пользовательское приложение установки могут упорядочивать записи журнала концептуально значимым образом. Например, диспетчер PnP может создать текстовый раздел журнала для группировки всех записей журнала, применяемых к установке устройства. Разделы текстового журнала отображаются в текстовом журнале в порядке их создания. Дополнительные сведения см. в разделе "Формат текстового журнала".

• Текстовый журнал может содержать записи журнала, которые не являются частью заголовка текстового журнала или текстового раздела журнала. Такие записи связаны с операциями, которые не являются частью какого-либо определенного раздела текстового журнала и, как правило, перемежаются между разделами текстового журнала. Записи журнала, которые не являются частью раздела текстового журнала, отображаются в журнале в том же порядке, в котором они записываются в текстовый журнал. Дополнительные сведения об этих записях журнала см. в разделе "Формат записей журнала, которые не являются частью раздела текстового журнала".