SetupAPI 文字記錄

  • 發行項

在 Windows Vista 和更新版本的 Windows 中， SetupAPI 支援裝置安裝文字記錄， (SetupAPI.dev.log) 和應用程式安裝文字記錄 (SetupAPI.app.log) 。 隨插即用 (PnP) 管理員和 SetupAPI 寫入專案到裝置安裝文字記錄檔，以提供安裝裝置和驅動程式之作業的相關資訊。 PnP 管理員和 SetupAPI 寫入專案至應用程式安裝文字記錄檔，提供與裝置和驅動程式安裝相關的安裝作業以外的安裝作業資訊。

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

SetupAPI 文字記錄檔是 ANSI 純文字檔案，預設位於 %SystemRoot%\inf 目錄中。 文字記錄檔是英文 (標準) 語言。

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

  • 記錄專案是文字記錄中的一行。

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

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

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

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