SetupAPI 文字記錄

在Windows Vista及以後版本的 Windows 中,SetupAPI 支援裝置安裝文字日誌(SetupAPI.dev.log)和應用程式安裝文字日誌(SetupAPI.app.log)。 隨插即用 (PnP) 管理員和 SetupAPI 會將專案寫入裝置安裝文字記錄檔,以提供安裝裝置和驅動程式之作業的相關資訊。 PnP 管理員和 SetupAPI 會將專案寫入應用程式安裝文字記錄檔,以提供安裝作業的相關資訊,但與裝置和驅動程式安裝相關的作業除外。

安裝應用程式、類別安裝程式和共同安裝程式可以使用 SetupAPI 記錄函式 ,將專案寫入裝置安裝記錄檔和應用程式安裝文字記錄檔。

SetupAPI 的文字日誌是 ANSI 純文字檔,預設位於 %SystemRoot%\inf 目錄中。 文字日誌是英文(標準)語言。

SetupAPI 文字記錄具有下列內部格式:

  • 日誌條目是文字日誌中的一行。

  • 前幾個記錄專案提供 文字記錄標頭 ,其中包含作業系統和電腦架構的相關資訊。 如需詳細資訊,請參閱 文字記錄標頭的格式。

  • 文字記錄標頭後面是零個或多個 文字記錄區段。 每個文字記錄區段都會記錄單一裝置安裝期間的事件。

    文字日誌區段的目的是將連續的日誌項目序列分組及格式化,以提供特定安裝作業的相關資訊。 藉由建立文字記錄區段,PnP 管理員、SetupAPI 或自訂安裝應用程式可以以概念上有意義的方式組織記錄專案。 例如,PnP 管理員可能會建立文字記錄區段,以將套用至安裝裝置的所有記錄專案分組。 文字記錄區段會依其建立順序顯示在文字記錄中。 如需詳細資訊,請參閱文字 記錄區段的格式。

  • 文字記錄檔可以包含不屬於文字記錄標頭或文字記錄區段的記錄項目。 這類項目與不屬於任何特定文字記錄區段的作業相關聯,而且一般會穿插在文字記錄區段之間。 不屬於文字記錄區段的記錄項目會以寫入文字記錄的相同順序出現在記錄中。 如需這類記錄項目的詳細資訊,請參閱 不 屬於文字記錄區段的記錄項目格式。