Memanggil SetupWriteTextLogInfLine

Aplikasi dapat memanggil SetupWriteTextLogInfLine untuk menulis entri log dalam log teks SetupAPI yang berisi teks baris file INF tertentu.

Untuk memanggil SetupWriteTextLogInfLine, aplikasi menyediakan informasi berikut:

• Token log untuk bagian dalam log teks yang diperoleh dengan memanggil SetupGetThreadLogToken atau salah satu token log yang ditentukan sistem. Jika token log dikaitkan dengan bagian log teks, SetupWriteTextLogInfLine menulis entri log di bagian tersebut. Jika tidak, SetupWriteTextLogInfLine menambahkan entri log ke bagian log yang tidak disertakan di bagian log teks.

  Selain itu, apakah SetupWriteTextLogInfLine menulis entri log, dan ke log teks mana SetupWriteTextLogInfLine menulis entri tersebut, tergantung pada nilai token log yang ditentukan sistem.

  Untuk informasi selengkapnya tentang token log, lihat Menyetel dan Mendapatkan Token Log untuk Utas.

• Nilai flag yang merupakan operasi OR bitwise dari konstanta yang didefinisikan sistem yang menentukan tingkat event, kedalaman indentasi, serta apakah akan menyertakan stempel waktu. Tingkat peristiwa dijelaskan dalam Mengatur Tingkat Peristiwa untuk Log Teks.

  Jika tingkat peristiwa yang diatur untuk log teks lebih besar dari atau sama dengan tingkat peristiwa untuk entri, SetupWriteTextLogInfLine menulis entri log di log teks. Jika tidak, SetupWriteTextLogInfLine tidak menulis entri log di log teks. Dengan menggunakan indentasi, pesan yang diformat dapat diatur untuk membuat informasi di bagian lebih mudah dibaca dan dipahami.

  Untuk informasi selengkapnya, lihat Menulis Entri Log Inden.

• Pegangan ke file INF yang berisi baris dalam file INF.

• Konteks untuk baris di file INF.

SetupWriteTextLogInfLine menulis entri log dalam format berikut:

entry_prefix time_stampinf:indentation inf-line-text(inf-file-namelineline-number)

Lokasi:

• Bidang entry_prefix, stempel waktu, dan indentasi sama dengan yang dijelaskan dalam Format Isi Bagian Log Teks.

• Bidang inf: menentukan kategori peristiwa TXTLOG_INF. Kategori peristiwa dijelaskan dalam Mengaktifkan Kategori Peristiwa untuk Log Teks.

• Bidang teks baris-inf berisi teks baris file INF yang ditentukan.

• Bidang inf-file-name berisi nama file INF yang berisi baris file INF yang ditentukan.

• Bidang baris menunjukkan bahwa yang mengikuti adalah nomor baris dalam file INF.

• Bidang nomor baris berisi nomor baris dari baris yang ditentukan dalam file INF.

Contoh berikut menunjukkan bagaimana aplikasi biasanya mencatat teks baris INF dalam log teks. Baris INF dalam contoh ini adalah baris INF AddReg . Aplikasi memanggil SetupWriteTextLogInfLine, menyediakan nilai parameter input berikut:

• LogToken diatur ke token log yang dikembalikan oleh SetupGetThreadLogToken atau ke token log yang ditentukan sistem.

• LogFlags diatur ke TXTLOG_DETAILS. Contoh ini tidak menyertakan stempel waktu atau mengubah kedalaman indentasi. Dalam contoh, kedalaman indentasi adalah lima spasi teks dengan font monospace.

• InfHandle ditetapkan ke handle ke file INF hidserv.inf. Handle ini diperoleh dengan memanggil fungsi SetupOpenInfFile, yang didokumentasikan dalam Platform SDK.

• Konteks diatur ke konteks file INF dari baris file INF yang berisi teks "AddReg=HidServ_AddService_AddReg." Konteks file INF untuk baris diperoleh dengan memanggil fungsi SetupFindXxxLine , yang didokumenkan dalam Platform SDK.

Nilai LogToken dan LogFlags memengaruhi operasi SetupWriteTextLogInfLine dengan cara yang sama seperti yang dijelaskan untuk SetupWriteTextLog. Selain itu, SetupWriteTextLogInfLine menggunakan katalog peristiwa TXTLOG_INF.

Untuk contoh ini, berikut ini menunjukkan jenis entri log yang akan ditulis SetupWriteTextLogInfLine ke log teks:

   inf:      AddReg=HidServ_AddService_AddReg  (hidserv.inf line 98)