文字記錄區段主體的格式

發行項
03/08/2023

文字記錄區段主體包含零個或多個記錄專案，這些記錄專案會套用至與文字記錄區段相關聯的作業。區段主體記錄專案的格式包括 entry_prefix 欄位、 time_stamp 欄位、 event_category 欄位、縮排欄位和 formatted_message 欄位，如下所示：

entry_prefix time_stamp event_category縮排formatted_message
區段主體記錄專案的長度上限為 336。

entry_prefix 欄位
指出記錄專案是錯誤訊息、警告訊息或資訊訊息。 entry_prefix欄位一律存在，並包含下表所列的其中一個字串：

Entry_prefix 欄位	訊息類型
"!!! "	錯誤訊息
"! "	警告訊息
" "	錯誤訊息或警告訊息以外的資訊訊息

time_stamp 欄位
指出記錄事件發生時的系統時間。 time_stamp欄位是選擇性的，而且 SetupAPI 預設不包含時間戳記。不過， SetupWriteTextLog 支援在記錄專案中加入時間戳記。 time_stamp欄位的格式與文字記錄區段標題格式中所述的time_stamp欄位格式相同。

event_category 欄位
指出建立記錄專案的 SetupAPI 作業類別。 event_category 欄位通常 存在，但並非必要。如果 event_category欄位存在 ，它會包含下表所列的其中一個字串：

Event_category 欄位字串	SetupAPI 作業
"...: "	廠商提供的作業
「bak：」	備份資料
「cci：」	類別安裝程式或共同安裝程式作業
「cpy：」	複製檔案
「dvi：」	裝置安裝
「flq：」	管理檔案佇列
「inf：」	管理 INF 檔案
「ndv：」	新增裝置精靈
「prp：」	管理裝置和驅動程式屬性
「reg：」	管理登錄庫設定
「set：」	一般設定
「sig：」	驗證數位簽章
「sto：」	管理驅動程式存放區
「ui ：」	管理使用者介面對話方塊
「ump：」	使用者模式 PnP 管理員

縮排欄位
包含零個或多個 縮排單位的序列，其中縮排單位是包含五個空格的單空白字元串。縮排欄位是選擇性的，而且 SetupAPI 預設不包含縮排。 SetupWriteTextLog 支援變更記錄專案中包含的縮排單位數目。

formatted_message 欄位
包含適用于記錄專案的特定資訊。

記錄的區段主體專案取決於針對記錄檔所設定的事件層級，以及針對記錄啟用的類別層級。如需這些設定的詳細資訊，請參閱 SetupAPI 記錄登錄設定。

當 SetupAPI 建立區段，將套用至裝置安裝的作業分組時，也會遞迴地將區段主體記錄專案分組在子區段中。 SetupAPI 會以標注和縮排記錄專案的方式來區分子區段。一個這類子區段會出現在一般裝置安裝區段的下列摘錄中。子區段的開頭為記錄專案「dvi： {Build Driver List}」，並以記錄專案「dvi： {Build Driver List - exit (0x00000000) }」結尾。這個子區段會顯示包含 entry_prefix、 event_category、縮排和 formatted_message 欄位的一般記錄專案序列。撰寫記錄專案的 SetupAPI 作業也會建立縮排，並提供格式化訊息的內容。此範例的事件層級設定為 TXTLOG_DETAILS，而且此範例已啟用所有類別層級。

>>>  [Device Install - PCI\VEN_104C&DEV_8019&SUBSYS_8010104C&REV_00\3&61aaa01&0&38]
>>>  2005/02/13 22:06:28.109: Section start
...
 Additional section body log entries
...
     dvi: {Build Driver List}
     dvi:      Enumerating all INFs...
     dvi:      Found driver match:
     dvi:           HardwareID - PCI\VEN_104C&DEV_8019
     dvi:           InfName    - C:\WINDOWS\inf\1394.inf
     dvi:           DevDesc    - Texas Instruments OHCI Compliant IEEE 1394 Host Controller
     dvi:           DrvDesc    - Texas Instruments OHCI Compliant IEEE 1394 Host Controller
     dvi:           Provider   - Microsoft
     dvi:           Mfg        - Texas Instruments
     dvi:           InstallSec - TIOHCI_Install
     dvi:           ActualSec  - TIOHCI_Install.NT
     dvi:           Rank       - 0x00002001
     dvi:           DrvDate    - 10/01/2002
     dvi:           Version    - 6.0.5033.0 
!!!  inf:      InfCache: Error flagging 1394.inf for match string pci\ven_104c&dev_8019
     dvi: {Build Driver List - exit(0x00000000)}
...
 Additional section body log entries 
...
<<<  [2005/02/13 22:06:29.000: Section end]
<<<  [Exit Status(0x00000000)]

共用方式為

文字記錄區段主體的格式

意見反應

其他資源