Fungsi IoSetActivityIdIrp (ntddk.h)

  • Artikel

Rutinitas IoSetActivityIdIrp mengaitkan ID aktivitas dengan IRP.

Sintaks

NTSTATUS IoSetActivityIdIrp(
  [in]           PIRP    Irp,
  [in, optional] LPCGUID Guid
);

Parameter

[in] Irp

IRP untuk mengaitkan ID aktivitas.

[in, optional] Guid

Penunjuk ke GUID yang mewakili ID untuk disimpan di IRP. Jika NULL, IoSetActivityIdIrp mencoba mengambil ID aktivitas dari utas saat ini jika utas yang awalnya mengeluarkan permintaan.

Nilai kembali

IoSetActivityIdIrp mengembalikan STATUS_SUCCESS jika panggilan berhasil. Kemungkinan nilai pengembalian kesalahan mencakup yang berikut ini.

Menampilkan kode Deskripsi
STATUS_NOT_SUPPORTED Tidak ada GUID yang disediakan dan ID aktivitas ETW tidak tersedia.
STATUS_UNSUCCESSFUL Penyedia pelacakan I/O belum diaktifkan pada IRP.

Keterangan

Driver harus menggunakan IoSetActivityIdIrp hanya pada IRP yang telah dialokasikan menggunakan IoAllocateIrp (dan dibebaskan menggunakan IoFreeIrp). Jika tidak, kebocoran memori dapat mengakibatkan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 8.
Target Platform Universal
Header ntddk.h (termasuk Ntddk.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Tingkat apa pun jika GUID diteruskan, jika tidak, PASSIVE_LEVEL.