Fungsi panggilan balik ETWENABLECALLBACK (wdm.h)

Fungsi EtwEnableCallback adalah fungsi panggilan balik opsional yang disediakan driver yang digunakan untuk menerima aktifkan atau nonaktifkan pemberitahuan.

Sintaks

ETWENABLECALLBACK Etwenablecallback;

void Etwenablecallback(
  [in]                LPCGUID SourceId,
                      ULONG ControlCode,
  [in]                UCHAR Level,
  [in]                ULONGLONG MatchAnyKeyword,
  [in]                ULONGLONG MatchAllKeyword,
  [in, optional]      PEVENT_FILTER_DESCRIPTOR FilterData,
  [in, out, optional] PVOID CallbackContext
)
{...}

Parameter

[in] SourceId

GUID yang mengidentifikasi sesi yang mengaktifkan penyedia.

ControlCode

[in] Level

Tingkat di mana peristiwa diaktifkan. Parameter ini adalah nilai yang ditentukan penyedia yang menentukan verboseness peristiwa yang ditulis penyedia. Penyedia harus menulis peristiwa jika nilai ini kurang dari atau sama dengan nilai tingkat yang ditentukan peristiwa.

Nilai ini diteruskan dalam parameter Tingkat fungsi EnableTraceEx atau parameter EnableLevel dari fungsi EnableTrace .

[in] MatchAnyKeyword

Bitmask kata kunci yang digunakan penyedia untuk menentukan kategori peristiwa yang ditulisnya.

Nilai ini diteruskan dalam parameter MatchAnyKeyword dari fungsi EnableTraceEx atau parameter EnableFlag dari fungsi EnableTrace . MatchAnyKeyword adalah nilai 64-bit dan pada dasarnya merupakan versi yang diperluas dari EnableFlag 32-bit.

[in] MatchAllKeyword

Bitmask ini juga membatasi kategori peristiwa yang ditulis penyedia.

Nilai ini diteruskan dalam parameter MatchAllKeywords dari fungsi EnableTraceEx .

[in, optional] FilterData

Data yang ditentukan penyedia. Parameter ini bersifat opsional. Penyedia menentukan tata letak data dan tujuannya. Misalnya, penyedia dapat menggunakan data ini untuk memfilter peristiwa yang ditulis atau menggunakannya untuk melakukan beberapa perhitungan sebelum menulis peristiwa. Untuk informasi selengkapnya, lihat Deskriptor Filter Peristiwa.

[in, out, optional] CallbackContext

Konteks fungsi panggilan balik yang ditentukan ketika penyedia memanggil EtwRegister untuk mendaftarkan dirinya sendiri. Parameter ini bersifat opsional.

Mengembalikan nilai

Tidak ada

Keterangan

Gunakan fungsi EtwRegister untuk menentukan penunjuk ke fungsi EtwEnableCallback .

Gunakan parameter FilterData dari fungsi panggilan balik untuk menyediakan penyedia dengan kemampuan pemfilteran canggih. Fungsi EtwEnableCallback tidak menggantikan panggilan fungsi enable-status (EtwEventEnabled dan EtwProviderEnabled). Namun, itu berfungsi sebagai suplemen untuk mereka. Namun, kecuali tingkat dan kata kunci Anda saat ini diaktifkan, peristiwa tidak akan ditulis, terlepas dari FilterData yang disediakan fungsi panggilan balik.

Pemanggil EtwEnableCallback harus berjalan di IRQL = PASSIVE_LEVEL dalam konteks utas sistem.

Persyaratan

   
Klien minimum yang didukung Tersedia di Windows Vista dan versi Windows yang lebih baru.
Target Platform Desktop
Header wdm.h (termasuk Wdm.h, Ntddk.h)
IRQL PASSIVE_LEVEL

Lihat juga

EnableTrace

EnableTraceEx

EtwEventEnabled

EtwProviderEnabled

EtwRegister

Deskriptor Filter Kejadian