Fungsi WdfRequestRetrieveActivityId (wdfrequest.h)

Artikel
08/08/2023

[Hanya berlaku untuk UMDF]

Metode WdfRequestRetrieveActivityId mengambil pengidentifikasi aktivitas saat ini yang terkait dengan permintaan I/O.

Sintaks

NTSTATUS WdfRequestRetrieveActivityId(
  [in]  WDFREQUEST Request,
  [out] LPGUID     ActivityId
);

Parameter

[in] Request

Handel ke objek permintaan kerangka kerja.

[out] ActivityId

Penunjuk ke lokasi untuk menyimpan GUID yang diambil.

Nilai kembali

Jika operasi berhasil, WdfRequestRetrieveActivityId mengembalikan STATUS_SUCCESS. Nilai pengembalian tambahan meliputi:

Menampilkan kode	Deskripsi
STATUS_NOT_FOUND	Tidak ada ID aktivitas yang terkait dengan permintaan.

Metode ini mungkin mengembalikan nilai NTSTATUS lainnya.

Keterangan

Permintaan yang tercermin dari mode kernel memiliki pengidentifikasi aktivitas yang tersedia hanya jika penyedia Pelacakan Kernel diaktifkan atau jika driver UMDF yang disebut WdfRequestSetActivityId setelah menerima permintaan. Untuk informasi selengkapnya tentang Pelacakan Peristiwa untuk Windows (ETW), lihat Pelacakan Peristiwa.

Permintaan yang dimulai oleh driver UMDF memiliki pengidentifikasi aktivitas yang tersedia hanya jika driver UMDF yang sebelumnya disebut WdfRequestSetActivityId.

Kerangka kerja tidak menghapus pengidentifikasi aktivitas permintaan saat driver memanggil WdfRequestReuse.

Untuk informasi selengkapnya tentang pengidentifikasi aktivitas, lihat Menggunakan Pengidentifikasi Aktivitas.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8.1
Target Platform	Universal
Versi UMDF minimum	2.0
Header	wdfrequest.h (termasuk Wdf.h)
Pustaka	WUDFx02000.lib
DLL	WUDFx02000.dll
IRQL	PASSIVE_LEVEL

Lihat juga

WdfRequestSetActivityId

Bagikan melalui