Поделиться через

Текстовые журналы setupAPI

  • Статья

В Windows Vista и более поздних версиях Windows SetupAPI поддерживает текстовый журнал установки устройства (SetupAPI.dev.log) и текстовый журнал установки приложения (SetupAPI.app.log). Диспетчер Plug and Play (PnP) и SetupAPI записывают записи в текстовый журнал установки устройств, чтобы предоставить сведения об операциях установки устройств и драйверов. Диспетчер PnP и SetupAPI записывают записи в текстовый журнал установки приложения, в которых содержатся сведения об операциях установки, отличных от операций установки, относящихся конкретно к установке устройств и драйверов.

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

Текстовые журналы SetupAPI — это обычные текстовые файлы ANSI, которые по умолчанию находятся в каталоге %SystemRoot%\inf . Текстовые журналы на английском языке (стандартный).

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

  • Запись журнала — это одна строка в текстовом журнале.

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

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

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

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