Format Isi Bagian Log Teks

Isi bagian log teks berisi nol atau beberapa entri log yang berlaku untuk operasi yang terkait dengan bagian log teks. Format entri log isi bagian mencakup bidang entry_prefix , bidang time_stamp , bidang event_category , bidang indentasi , dan bidang formatted_message , sebagai berikut:

formatted_message indentasi entry_prefix time_stamp event_category
Panjang maksimum, dalam karakter, dari entri log isi bagian adalah 336.

bidang entry_prefix
Menunjukkan apakah entri log adalah pesan kesalahan, pesan peringatan, atau pesan informasi. Bidang entry_prefix selalu ada dan berisi salah satu string yang tercantum dalam tabel berikut:

bidang Entry_prefix	Jenis pesan
"!!!    "	Pesan kesalahan
"!      "	Pesan peringatan
" "	Pesan informasi selain pesan kesalahan atau pesan peringatan

bidang time_stamp
Menunjukkan waktu sistem ketika peristiwa yang dicatat terjadi. Bidang time_stamp bersifat opsional dan SetupAPI tidak menyertakan stempel waktu secara default. Namun, SetupWriteTextLog mendukung termasuk stempel waktu dalam entri log. Format bidang time_stamp sama dengan format bidang time_stamp yang dijelaskan dalam Format Header Bagian Log Teks.

bidang event_category
Menunjukkan kategori operasi SetupAPI yang membuat entri log. Bidang event_category biasanya ada, tetapi tidak diperlukan. Jika bidang event_category ada, bidang tersebut akan berisi salah satu string yang tercantum dalam tabel berikut:

Event_category string bidang	Operasi SetupAPI
"...: "	Operasi yang disediakan vendor
"bak: "	Mencadangkan data
"cci: "	Operasi penginstal kelas atau penginstal bersama
"cpy: "	Salin file
"dvi: "	Penginstalan perangkat
"flq: "	Mengelola antrean file
"inf: "	Mengelola file INF
"ndv: "	Wizard perangkat baru
"prp: "	Mengelola properti perangkat dan driver
"reg: "	Mengelola pengaturan registri
"set: "	Penyiapan umum
"sig: "	Memverifikasi tanda tangan digital
"sto: "	Mengelola penyimpanan driver
"ui : "	Mengelola kotak dialog antarmuka pengguna
"ump: "	Manajer PnP mode pengguna

bidang indentasi
Terdiri dari urutan nol atau lebih unit indentasi, di mana unit indentasi adalah string monospace yang berisi lima spasi. Bidang indentasi bersifat opsional dan SetupAPI tidak menyertakan indentasi secara default. SetupWriteTextLog mendukung perubahan jumlah unit indentasi yang disertakan dalam entri log.

bidang formatted_message
Berisi informasi spesifik yang berlaku untuk entri log.

Entri isi bagian yang dicatat bergantung pada tingkat peristiwa yang diatur untuk log dan tingkat kategori yang diaktifkan untuk log. Untuk informasi selengkapnya tentang pengaturan ini, lihat PenyiapanPengaturan Registri Pengelogan API.

Saat SetupAPI membuat bagian yang mengelompokkan operasi yang berlaku untuk penginstalan perangkat, itu juga secara rekursif mengelompokkan entri log isi bagian dalam subbagian. SetupAPI membedakan subbagian dengan cara membuat anotasi dan inden entri log. Salah satu subbagian tersebut muncul dalam kutipan berikut dari bagian penginstalan perangkat biasa. Subbagian dimulai dengan entri log "dvi: {Build Driver List}" dan diakhir dengan entri log "dvi: {Build Driver List - exit(0x00000000)}". Subbagian ini memperlihatkan urutan umum entri log yang mencakup bidang entry_prefix, event_category, indentasi, dan formatted_message . Operasi SetupAPI yang menulis entri log juga membuat indentasi dan menyediakan konten pesan yang diformat. Tingkat peristiwa untuk contoh ini diatur ke TXTLOG_DETAILS dan semua tingkat kategori diaktifkan untuk contoh ini.

>>>  [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)]