Fungsi FltPropagateActivityIdToThread (fltkernel.h)
Rutinitas FltPropagateActivityIdToThread mengaitkan ID aktivitas dari IRP dalam data panggilan balik minifilter dengan utas saat ini.
Sintaks
NTSTATUS FLTAPI FltPropagateActivityIdToThread(
[in] PFLT_CALLBACK_DATA CallbackData,
[in/out] LPGUID PropagateId,
[out] LPCGUID *OriginalId
);
Parameter
[in] CallbackData
Arahkan ke data panggilan balik yang berisi permintaan dengan ID aktivitas terkait.
[in/out] PropagateId
Pointer ke GUID yang dialokasikan penelepon yang menyimpan ID aktivitas untuk utas saat ini.
[out] OriginalId
Saat kembali, penunjuk GUID yang dirujuk oleh titik OriginalId ke ID aktivitas yang sebelumnya diatur untuk utas.
Nilai kembali
FltPropagateActivityIdToThread mengembalikan salah satu nilai NTSTATUS berikut.
| Menampilkan kode | Deskripsi |
|---|---|
| STATUS_NOT_SUPPORTED | Data panggilan balik tidak berisi permintaan untuk operasi IRP. |
| STATUS_NOT_FOUND | Tidak ada ID aktivitas yang terkait dengan permintaan di CallbackData. |
| STATUS_SUCCESS | ID aktivitas dikembalikan dalam nilai GUID yang ditujukkan oleh OriginalId. |
Keterangan
Rutinitas FltPropagateActivityIdToThread digunakan oleh minifilter sadar jejak. Minifilter menggunakan rutinitas ini untuk melampirkan ID aktivitas dari IRP ke alur pekerja yang memproses I/O untuk permintaan tersebut.
Minifilter harus memanggil IoClearActivityIdThread dengan pointer di OriginalId sebelum mengembalikan kontrol dari utas pekerja jika panggilan ke FltPropagateActivityIdToThread berhasil.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia dimulai dengan Windows 8. |
| Target Platform | Universal |
| Header | fltkernel.h (termasuk Fltkernel.h) |
| Pustaka | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= DISPATCH_LEVEL |