Fungsi EtwUnregister (wdm.h)

  • Artikel

Fungsi EtwUnregister membatalkan pendaftaran penyedia peristiwa dan harus dipanggil sebelum penyedia keluar.

Sintaks

NTSTATUS EtwUnregister(
  [in] REGHANDLE RegHandle
);

Parameter

[in] RegHandle

Penunjuk ke handel pendaftaran penyedia, yang dikembalikan oleh fungsi EtwRegister jika pendaftaran penyedia peristiwa berhasil.

Nilai kembali

Fungsi EtwUnregister mengembalikan kode status STATUS_SUCCESS jika penyedia peristiwa berhasil tidak terdaftar dengan ETW.

Keterangan

Setelah pelacakan selesai, driver harus memanggil fungsi EtwUnregister untuk membatalkan pendaftaran penyedia. Untuk setiap panggilan ke EtwRegister harus ada panggilan yang sesuai ke EtwUnregister. Kegagalan untuk membatalkan pendaftaran penyedia peristiwa dapat menyebabkan kesalahan ketika proses dibongkar karena panggilan balik yang terkait dengan proses tidak lagi valid. Tidak ada panggilan pelacakan yang harus dilakukan yang berada di luar kode yang dibatasi oleh fungsi EtwRegister dan EtwUnregister . Untuk performa terbaik, Anda dapat memanggil fungsi EtwRegister dalam rutinitas DriverEntry Anda dan fungsi EtwUnregister dalam rutinitas DriverUnload Anda.

Penelepon EtwRegister harus berjalan di IRQL = PASSIVE_LEVEL dalam konteks utas sistem.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header wdm.h (termasuk Wdm.h, Ntddk.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe; Ntdll.dll
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Lihat juga

EtwRegister