文字記錄區段的格式
文字記錄區段包含開啟區段的區段標頭、包含套用至區段作業之記錄專案的區段主體,以及關閉區段的區段頁尾。 區段專案會以寫入區段的相同順序出現在區段中。
下列文字記錄區段範例顯示一般區段的格式,其中斜體字型樣式中的欄位是區段特定文字的佔位元,而粗體字型樣式的其餘文字則是 SetupAPI 提供的一般文字。 前兩個記錄項目組成區段標頭,最後兩個記錄專案則組成區段頁尾。
>>> [section_title - instance_identifier]
>>> time_stamp Section start
section body log entry
section body log entry
section body log entry
<<< [time_stamp: Section end]
<<< [Exit Status(status_value)]
記錄的區段主體專案取決於針對記錄檔所設定的事件層級,以及針對記錄啟用的類別層級。 如需這些設定的詳細資訊,請參閱 SetupAPI 記錄登錄設定。
以下是文字記錄區段的典型範例,隨插即用 (PnP) 管理員建立,以記錄與PCI裝置安裝相關的專案。 在區段標頭中, [section_title ] 欄位是 [裝置安裝], instance_identifier 欄位是裝置實例標識符 “PCI\VEN_104C&DEV_8019&SUBSYS_8010104C&REV_00\3&61aaa01&0&38”,而 time_stamp 字段是 “2005/02/13 22:06:28.109:”。在區段頁尾中, [status_value ] 欄位是 「0x00000000」, 而time_stamp 欄位是 “2005/02/13 22:06:20.000:”。此範例中只會包含前三個區段主體記錄專案。 此範例的事件層級設定為 TXTLOG_DETAILS,而且此範例已啟用所有類別層級。
>>> [Device Install - PCI\VEN_104C&DEV_8019&SUBSYS_8010104C&REV_00\3&61aaa01&0&38]
>>> 2005/02/13 22:06:20.000: Section start
ndv: Retrieving device info...
ndv: Setting device parameters...
ndv: Building driver list...
...
... additional section body log entries, which are not shown
...
<<< [2005/02/13 22:06:28.109: Section end]
<<< [Exit Status(0x00000000)]
如需文字記錄檔內容和格式的詳細資訊,請參閱 文字記錄區段頁首的格式、 文字記錄區段主體的格式,以及 文字記錄區段頁尾的格式。