Fungsi EtwActivityIdControl (wdm.h)

  • Artikel

Fungsi EtwActivityIdControl membuat, mengkueri, dan mengatur pengidentifikasi aktivitas saat ini.

Sintaks

NTSTATUS EtwActivityIdControl(
  [in]      ULONG  ControlCode,
  [in, out] LPGUID ActivityId
);

Parameter

[in] ControlCode

Parameter ControlCode dapat menjadi salah satu nilai yang ditentukan berikut.

Nilai Makna
EVENT_ACTIVITY_CTRL_GET_ID Mengembalikan pengidentifikasi aktivitas utas saat ini dalam parameter ActivityId .
EVENT_ACTIVITY_CTRL_SET_ID Mengatur pengidentifikasi aktivitas utas saat ini ke nilai yang ditentukan dalam ActivityId. Perhatikan bahwa ActivityId yang Anda berikan ke fungsi ini tidak harus satu yang dibuat oleh kode kontrol EVENT_ACTIVITY_CTRL_CREATE_ID atau EVENT_ACTIVITY_CTRL_CREATE_SET_ID . Anda dapat menggunakan nilai apa pun yang pas di dalam GUID, termasuk nilai lokal yang tersedia yang akan melayani kebutuhan Anda untuk beberapa jenis pengidentifikasi aktivitas.
EVENT_ACTIVITY_CTRL_CREATE_ID Membuat pengidentifikasi baru dan mengatur parameter ActivityId ke nilai pengidentifikasi baru.
EVENT_ACTIVITY_CTRL_GET_SET_ID Mengatur pengidentifikasi aktivitas utas saat ini ke nilai yang ditentukan dalam ActivityId, lalu mengembalikan ActivityId dengan nilai pengidentifikasi aktivitas utas sebelum panggilan fungsi.
EVENT_ACTIVITY_CTRL_CREATE_SET_ID Menyalin pengidentifikasi aktivitas utas saat ini. Membuat pengidentifikasi baru dan mengatur pengidentifikasi aktivitas utas saat ini ke nilai baru. Mengembalikan ActivityId dengan nilai pengidentifikasi aktivitas utas sebelum panggilan fungsi.

[in, out] ActivityId

Pengidentifikasi yang menunjukkan aktivitas yang terkait dengan peristiwa. Parameter ActivityId menyediakan cara untuk mengelompokkan peristiwa terkait dan digunakan dalam pelacakan end-to-end.

Mengembalikan nilai

EtwActivityIdControl mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai.

Keterangan

Pengidentifikasi aktivitas menyediakan metode penautan peristiwa terpisah dalam utas komputasi umum. Aktivitas adalah item kerja yang dilakukan oleh aplikasi dan atau driver. Konsep aktivitas adalah komponen inti dalam pelacakan end-to-end.

Penelepon EtwActivityIdControl harus berjalan di IRQL < DISPATCH_LEVEL, kecuali ControlCodeEVENT_ACTIVITY_CTRL_CREATE_ID, dalam hal ini fungsi dapat dipanggil di IRQL apa pun.

Gunakan fungsi EtwActivityIdControlKernel untuk mengkueri atau mengatur utas kernel pengidentifikasi aktivitas.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header wdm.h (termasuk Wdm.h, Ntddk.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe; Ntdll.dll
IRQL Lihat bagian Komentar

Lihat juga

EtwActivityIdControlKernel