Direktif ADDEventProvider INF

Direktif AddEventProvider digunakan dalam INF DDInstall. Bagian peristiwa. Ini menentukan karakteristik penyedia Pelacakan Peristiwa untuk Windows (ETW) yang terkait dengan driver. Arahan ini didukung untuk Windows 10 versi 1809 dan yang lebih baru.

[DDInstall.Events] 

AddEventProvider={ProviderGUID},event-provider-install-section
...

Entri

ProviderGUID
Menentukan nilai GUID yang mengidentifikasi penyedia. Ini dapat dinyatakan sebagai nilai GUID eksplisit dari formulir {nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn} atau sebagai token %strkey% yang didefinisikan dalam {nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn} bagian String dari file INF.

event-provider-install-section
Mereferensikan bagian yang ditentukan penulis INF yang berisi informasi untuk mendaftarkan penyedia untuk perangkat ini (atau perangkat). Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Keterangan

Ekstensi yang ditentukan sistem dan tidak peka huruf besar/kecil dapat dimasukkan ke dalam DDInstall. Bagian peristiwa yang berisi arahan AddEventProvider dalam sistem operasi silang dan/atau file INF lintas platform untuk menentukan penginstalan khusus platform atau khusus OS.

Setiap nama bagian yang dibuat penulis INF harus unik dalam file INF dan harus mengikuti aturan umum untuk menentukan nama bagian. Untuk informasi selengkapnya tentang aturan ini, lihat Aturan Sintaks Umum untuk File INF.

Direktif AddEventProvider harus mereferensikan event-provider-install-section bernama di tempat lain dalam file INF. Setiap bagian tersebut memiliki formulir berikut:

[event-provider-install-section]
 
ProviderName=name
ResourceFile=path-to-file
[MessageFile=path-to-file]
[ParameterFile=path-to-file]
(ImportChannel=channel-name) |
(AddChannel=channel-name,channel-type[,channel-install-section])
...

Setiap event-provider-install-section harus menyediakan ProviderName dan ResourceFile. Secara opsional, tentukan daftar saluran untuk penyedia menggunakan kombinasi ImportChannel dan AddChannel, masing-masing pada baris terpisah. Untuk informasi selengkapnya tentang daftar saluran dalam file INF, lihat Menentukan Daftar Saluran di bawah ini. Untuk informasi selengkapnya tentang saluran Log Peristiwa Windows , lihat Menentukan Saluran.

Entri dan Nilai Bagian Event-Provider-Install

ProviderName=Nama
Menentukan nama penyedia. Nama tidak boleh lebih panjang dari 255 karakter, dan tidak boleh berisi karakter: '>', '<', '&', '"', '|', '', ':', ''', '?', '*', atau karakter dengan nilai ASCII kurang dari 31. Selain itu, nama harus mengikuti batasan umum pada nama kunci file dan registri. Batasan ini dapat ditemukan di Penamaan Batas Ukuran Elemen File dan Registri.

ResourceFile=path-to-file
Menentukan jalur ke exe atau dll yang berisi sumber daya metadata penyedia, yang dinyatakan sebagai %dirid%\filename.

Nomor dirid adalah pengidentifikasi direktori kustom atau salah satu pengidentifikasi direktori yang ditentukan sistem yang dijelaskan dalam Menggunakan Dirids.

MessageFile=path-to-file
Secara opsional menentukan jalur ke exe atau dll yang berisi sumber daya pesan penyedia yang dilokalkan, yang dinyatakan sebagai %dirid%\filename.

ParameterFile=path-to-file
Secara opsional menentukan jalur ke exe atau dll yang berisi sumber daya string parameter penyedia, yang dinyatakan sebagai %dirid%\filename.

ImporChannel=nama saluran
Secara opsional menentukan saluran yang telah ditentukan oleh penyedia lain. Untuk informasi selengkapnya, lihat bagian Menentukan Daftar Saluran berikut ini.

TambahkanChannel=channel-name,channel-type[,channel-install-section]
Secara opsional menentukan saluran dengan subrektif yang secara opsional mereferensikan bagian penginstalan saluran yang ditentukan penulis INF di tempat lain dalam file INF. Untuk informasi selengkapnya, lihat bagian Menentukan Daftar Saluran berikut ini.

Menentukan Daftar Saluran

Anda dapat menentukan daftar saluran untuk penyedia dalam event-provider-install-section. Anda dapat mengimpor saluran atau menambahkan saluran ke daftar dan urutan saluran ini dipertahankan. Untuk informasi selengkapnya, lihat Menentukan Saluran.

Nama saluran harus unik dalam daftar saluran yang digunakan penyedia. Nama saluran harus kurang dari 255 karakter dan tidak boleh berisi karakter berikut: '>', '<', '&', '"', '|', '', ':', ''', '?', '*', atau karakter dengan nilai ASCII kurang dari 31.

Jenis saluran dapat ditentukan sebagai salah satu nilai numerik berikut, yang dinyatakan baik dalam desimal atau, seperti yang ditunjukkan dalam daftar berikut, dalam notasi heksadesimal.

0x1 (Admin)
Admin jenis saluran mendukung peristiwa yang menargetkan pengguna akhir, administrator, dan personel dukungan. Peristiwa yang ditulis ke saluran Admin harus memiliki solusi yang terdefinisi dengan baik di mana administrator dapat bertindak.

0x2 (Operasional)
Saluran jenis operasional mendukung peristiwa yang digunakan untuk menganalisis dan mendiagnosis masalah atau kemunculan. Mereka dapat digunakan untuk memicu alat atau tugas berdasarkan masalah atau kemunculannya.

0x3 (Analitik)
Saluran jenis analitik mendukung peristiwa yang diterbitkan dalam volume tinggi. Mereka menjelaskan operasi program dan menunjukkan masalah yang tidak dapat ditangani oleh intervensi pengguna.

0x4 (Debug)
Saluran jenis debug mendukung peristiwa yang hanya digunakan oleh pengembang untuk mendiagnosis masalah untuk penelusuran kesalahan.

Sub-direktif AddChannel juga dapat mereferensikan bagian penginstalan saluran di tempat lain dalam file INF. Setiap bagian tersebut memiliki formulir berikut:

[channel-install-section]

[Isolation=isolation-type]
[Access=access-string]
[Enabled=0|1]
[Value=value]
[LoggingMaxSize=max-size]
[LoggingRetention=retention-type]
[LoggingAutoBackup=0|1]

Untuk informasi selengkapnya tentang atribut saluran, lihat ChannelType yang ditentukan dalam EventManifest Schema.

Channel-Install Entri dan Nilai Bagian

Isolasi=jenis isolasi
Secara opsional menentukan izin akses default untuk saluran sebagai salah satu nilai numerik berikut, yang dinyatakan baik dalam desimal atau, seperti yang ditunjukkan dalam daftar berikut, dalam notasi heksadesimal. Jika dihilangkan, ini default ke 0x1 (Aplikasi).

0x1 (Aplikasi)

0x2 (Sistem)

0x3 (Kustom)

Akses=access-string
Secara opsional menentukan deskriptor akses Security Descriptor Definition Language (SDDL) yang mengontrol akses ke file log yang mendukung saluran.

String ini mengontrol akses baca ke file (izin tulis diabaikan) jika Isolasi diatur ke 0x1 (Aplikasi) atau 0x2 (Sistem), sementara mengontrol akses tulis ke saluran dan membaca akses ke file jika atribut isolasi diatur ke 0x3 (Kustom).

Diaktifkan=0|1
Secara opsional menentukan apakah saluran diaktifkan. Jika dihilangkan, ini default ke 0 (dinonaktifkan).

Karena 0x3 (Analitik) dan jenis saluran0x4 (Debug) adalah saluran volume tinggi, Anda harus mengatur Diaktifkan ke 1 hanya saat menyelidiki masalah dengan komponen yang menulis ke saluran tersebut. Setiap kali Anda mengaktifkan saluran 0x3 (Analytic) dan 0x4 (Debug), layanan akan menghapus peristiwa dari saluran.

Nilai=Nilai
Secara opsional menentukan pengidentifikasi numerik yang secara unik mengidentifikasi saluran dalam daftar saluran yang ditentukan penyedia.

LoggingMaxSize=ukuran maks
Secara opsional menentukan ukuran maksimum, dalam byte, dari file log. Nilai default (dan minimum) adalah 1 MB.

LoggingRetention=jenis retensi
Secara opsional menentukan apakah file log 0x1 (melingkar) atau 0x2 (berurutan). Defaultnya adalah 0x1 (melingkar) untuk jenis saluran0x1 (Admin) dan 0x2 (Operasional) dan 0x2 (berurutan) untuk jenis saluran0x3 (Analitik) dan 0x4 (Debug).

LoggingAutoBackup=0|1
Secara opsional menentukan apakah akan membuat file log baru ketika file log saat ini mencapai ukuran maksimumnya. Atur ke 1 untuk meminta layanan membuat file baru saat file log mencapai ukuran maksimumnya; jika tidak, 0. Anda dapat mengatur LoggingAutoBackup ke 1 hanya jika LoggingRetention diatur ke 0x2 (berurutan) dan hanya untuk jenis saluran0x1 (Admin) dan 0x2 (Operasional).

Contoh

Contoh ini menunjukkan bagian event-provider-install yang direferensikan oleh direktif AddEventProvider seperti yang sudah ditunjukkan sebelumnya dalam contoh untuk DDInstall. Peristiwa.

[foo_Event_Provider_Inst]
ProviderName  = FooCollector
ResourceFile  = %13%\FooResource.dll
MessageFile   = %13%\FooMessage.exe

[bar_Event_Provider_Inst]
ProviderName  = BarCollector
ResourceFile  = %13%\BarResource.exe
MessageFile   = %13%\BarMessage.dll
ParameterFile = %13%\BarParameter.dll
ImportChannel = Microsoft-Windows-BaseProvider/Admin
AddChannel    = Bar-Provider/Admin,0x1,bar_Channel2_Inst    ; Admin type
ImportChannel = Microsoft-Windows-BaseProvider/Operational
ImportChannel = Microsoft-Windows-SampleProvider/Admin
AddChannel    = Bar-Provider/Debug,0x4                      ; Debug type

[bar_Channel2_Inst]
Isolation         = 2                                       ; System isolation
Enabled           = 1
Value             = 17
LoggingMaxSize    = 20971520
LoggingRetention  = 2                                       ; Sequential
LoggingAutoBackup = 1

Lihat juga

DDInstall. Peristiwa