Fungsi IoPropagateActivityIdToThread (ntddk.h)

Rutinitas IoPropagateActivityIdToThread mengaitkan ID aktivitas dari IRP dengan utas saat ini.

Sintaks

NTSTATUS IoPropagateActivityIdToThread(
  [in]  PIRP    Irp,
  [out] LPGUID  PropagatedId,
        LPCGUID *OriginalId
);

Parameter

[in] Irp

IRP yang ID-nya akan disebarluaskan ke utas.

[out] PropagatedId

Pointer ke memori yang dialokasikan oleh penelepon untuk menyimpan ID di utas.

OriginalId

Setelah berhasil kembali dari panggilan, memegang ID yang sebelumnya diatur pada utas. Driver harus memanggil IoClearActivityIdThread dengan pointer ini saat pelacakan selesai dalam konteks utas yang sama.

Nilai kembali

IoPropagateActivityIdToThread mengembalikan STATUS_SUCCESS jika panggilan berhasil. Kemungkinan nilai pengembalian kesalahan termasuk yang berikut ini.

Menampilkan kode	Deskripsi
STATUS_NOT_FOUND	IRP tidak memiliki ID yang terkait dengannya.

Keterangan

Rutinitas ini harus digunakan oleh driver yang mengetahui pelacakan dan mengeluarkan I/O pada utas pekerja. Perhatikan bahwa driver tersebut harus memanggil IoClearActivityIdThread dengan OriginalId sebelum mereka mengembalikan kontrol dari utas, jika panggilan berhasil.

Driver yang menggunakan item kerja I/O tidak perlu memanggil rutinitas ini karena subsistem I/O mengurus penyebaran ID aktivitas ke utas dalam hal ini.

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