Fungsi FsRtlPostStackOverflow (ntifs.h)

  • Artikel

Rutinitas FsRtlPostStackOverflow memposting item luapan tumpukan ke utas luapan tumpukan.

Sintaks

void FsRtlPostStackOverflow(
  [in] PVOID                         Context,
  [in] PKEVENT                       Event,
  [in] PFSRTL_STACK_OVERFLOW_ROUTINE StackOverflowRoutine
);

Parameter

[in] Context

Penunjuk konteks yang akan diteruskan ke rutinitas panggilan balik luapan tumpukan.

[in] Event

Penunjuk ke peristiwa pemberitahuan yang dialokasikan penelepon untuk diteruskan ke rutinitas panggilan balik luapan tumpukan. Pasti diinisialisasi sebagai tidak ditandatangani dengan memanggil KeInitializeEvent.

[in] StackOverflowRoutine

Penunjuk ke rutinitas panggilan balik untuk dipanggil saat memproses permintaan di utas luapan.

Nilai kembali

Tidak ada

Keterangan

Sistem file biasanya memanggil FsRtlPostStackOverflow selama operasi I/O file ketika jumlah ruang tumpukan yang tersisa yang dikembalikan oleh IoGetRemainingStackSize berada di bawah ambang batas luapan tumpukan sistem file untuk operasi. FsRtlPostStackOverflow memposting permintaan I/O ke antrean kerja luapan tumpukan khusus. Ketika operasi I/O telah selesai, Peristiwa penelepon diatur ke status yang disinyalkan.

Driver filter sistem file harus menggunakan IoQueueWorkItemalih-alih FsRtlPostStackOverflow, karena IoQueueWorkItem memastikan bahwa objek perangkat yang terkait dengan item kerja yang ditentukan tersedia untuk pemrosesan item kerja.

Jika kegagalan alokasi kumpulan terjadi, FsRtlPostStackOverflow akan memunculkan pengecualian STATUS_INSUFFICIENT_RESOURCES. Untuk mendapatkan kontrol jika kegagalan alokasi kumpulan ini terjadi, driver harus membungkus panggilan ke FsRtlPostStackOverflow dalam pernyataan try-except atau try-finally .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000
Target Platform Universal
Header ntifs.h (termasuk FltKernel.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

Lihat juga

FsRtlPostPagingFileStackOverflow

IoGetRemainingStackSize

IoQueueWorkItem

KeInitializeEvent