設定文字記錄的事件層級

只有當文本日志設定的事件層級大於或等於日志項目的事件層級，且日志項目的事件類別有啟用時，SetupAPI 才會將該日志項目寫入文本日志中。

下表列出 SetupAPI 支援的事件層級，以及代表這些事件層級的指令清單常數。 TXTLOG_ERROR是最低事件層級，後面接著下一個最高事件層級TXTLOG_WARNING等等。 TXTLOG_VERY_VERBOSE是最高事件層級。

事件層級	事件層級清單常數	事件層級指令清單值
僅寫下錯誤。	文本日誌_錯誤	1
記錄錯誤和潛在問題的警告。	TXTLOG_WARNING	2
寫入錯誤、警告和系統狀態變更。	系統狀態變更記錄	3
寫入與狀態變更相關的錯誤、警告、系統狀態變更，以及高層次操作。	TXTLOG_SUMMARY	4
寫入錯誤、警告、系統狀態變更、與狀態變更相關聯的高階作業，以及大部分的作業詳細數據。	TXTLOG_DETAILS	5
寫入錯誤、警告、系統狀態變更、與狀態變更相關聯的高階作業，以及所有作業詳細數據。	TXTLOG_VERBOSE	6
寫入所有日誌條目，包括那些可能會生成大量且經常多餘的資訊。	TXTLOG_VERY_VERBOSE	7

若要設定 SetupAPI 文字記錄的事件層級，請建立 （或修改） 下列 REG_DWORD 登錄值：
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Setup\LogLevel

如果 LogLevel 登入值不存在或值為零，SetupAPI 會將應用程式安裝和裝置安裝文字記錄的事件層級設定為下表所述的預設值：

文字記錄檔	預設值 （Windows 7 和更新版本）	預設值 （Windows Vista SP2）	預設值 （Windows Vista SP1 和舊版）
應用程式安裝文字記錄檔 （SetupAPI.app.log）	TXTLOG_SUMMARY	TXTLOG_WARNING	TXTLOG_DETAILS
裝置安裝文字記錄檔 （SetupAPI.dev.log）	TXTLOG_DETAILS	TXTLOG_DETAILS	文本日誌詳情

如需這些文字記錄檔的詳細資訊，請參閱 SetupAPI Text Logs。

LogLevel 登錄值的格式為 0xUUUUGHVW，其中：

• 由遮罩 0x000000VW 表示的低序八位元，指定是否啟動應用程式安裝記錄的記錄功能，並設定應用程式記錄的事件層級。

• 接下來最高的八位元以遮罩0x0000GH00 表示，用於指定是否啟用裝置安裝文字記錄的記錄功能及指定其事件層級。

• 最高層級位，表示為遮罩 0xUUUU0000，不會被使用。

0xVW 位元的值會控制應用程式安裝記錄檔的記錄功能，如下表所示。

0xVW 值	說明
零 （預設值）	記錄已開啟，事件層級會設定為預設值，如先前所述。
透過0x0F 0x01	關閉記錄功能。
透過0x7F 0x10	開啟記錄，並將事件層級設定為 0xV。

0xGH 位的值會控制裝置安裝文字記錄檔的記錄，如下表所示。

0xGH 值	說明
零 （預設值）	記錄已開啟，事件層級會設定為預設值，如先前所述。
0x01到0x0F	關閉記錄功能。
0x10 至 0x7F	開啟日誌記錄，並將事件層級設定為 0xG。

下表提供一般 LogLevel 值的範例。

LogLevel 值	為文字記錄設定的事件層級
0x00000000	根據預設，開啟應用程式安裝記錄檔和裝置安裝記錄檔的登入。 將記錄層級設定為這兩個記錄的預設值。
0x00000101	關閉應用程式安裝日誌記錄和裝置安裝日誌記錄功能。
0x00001010	開啟應用程式安裝記錄檔和裝置安裝記錄檔的登入。 將這兩個記錄檔的記錄層級設定為TXTLOG_ERROR。
0x00002020	開啟應用程式安裝記錄檔和裝置安裝記錄檔的登入。 將這兩個記錄檔的記錄層級設定為TXTLOG_WARNING。
0x00005050	開啟應用程式安裝記錄檔和裝置安裝記錄檔的登入。 將這兩個記錄的記錄層級設定為TXTLOG_DETAILS。
0x00006060	開啟應用程式安裝記錄檔和裝置安裝記錄檔的登入。 將這兩個記錄檔的記錄層級設定為TXTLOG_VERBOSE。
0x00007070	開啟應用程式安裝記錄檔和裝置安裝記錄檔的登入。 將這兩個記錄檔的記錄層級設定為TXTLOG_VERY_VERBOSE。