Fungsi IoGetTopLevelIrp (ntifs.h)

Rutinitas IoGetTopLevelIrp mengembalikan nilai bidang TopLevelIrp dari utas saat ini.

Sintaks

PIRP IoGetTopLevelIrp();

Mengembalikan nilai

IoGetTopLevelIrp mengembalikan nilai bidang TopLevelIrp dari utas saat ini.

Keterangan

IoGetTopLevelIrp dapat mengembalikan NULL, nilai spesifik sistem file arbitrer (seperti penunjuk ke IRP saat ini), atau salah satu bendera yang tercantum dalam tabel berikut.

Jika utas saat ini tidak menyimpan sumber daya di atas sistem file, IoGetTopLevelIrp mengembalikan NULL.

Jika sistem file adalah komponen tingkat atas untuk utas saat ini, IoGetTopLevelIrp mengembalikan penunjuk ke IRP saat ini.

Jika komponen selain sistem file adalah komponen tingkat atas untuk utas saat ini, IoGetTopLevelIrp mengembalikan salah satu bendera berikut:

Bendera	Makna
FSRTL_FSP_TOP_LEVEL_IRP	Ini adalah panggilan rekursif.
FSRTL_CACHE_TOP_LEVEL_IRP	Manajer cache adalah komponen tingkat atas untuk utas saat ini.
FSRTL_MOD_WRITE_TOP_LEVEL_IRP	Penulis halaman yang dimodifikasi adalah komponen tingkat atas untuk utas saat ini.
FSRTL_FAST_IO_TOP_LEVEL_IRP	Manajer cache adalah komponen tingkat atas untuk utas saat ini, dan utas saat ini berada di jalur I/O yang cepat.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	ntifs.h (termasuk Ntifs.h, Wdm.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

Lihat juga

IoSetTopLevelIrp