Fungsi FltCompletePendedPreOperation (fltkernel.h)

Artikel
08/07/2023

FltCompletePendedPreOperation melanjutkan pemrosesan untuk operasi I/O yang tertunda dalam rutinitas panggilan balik praoperasi driver minifilter (PFLT_PRE_OPERATION_CALLBACK).

Sintaks

VOID FLTAPI FltCompletePendedPreOperation(
                 PFLT_CALLBACK_DATA        CallbackData,
  [in]           FLT_PREOP_CALLBACK_STATUS CallbackStatus,
  [in, optional] PVOID                     Context
);

Parameter

CallbackData

Arahkan ke struktur data panggilan balik (FLT_CALLBACK_DATA) untuk operasi I/O. Parameter ini diperlukan dan tidak boleh NULL.

[in] CallbackStatus

Nilai status yang dikembalikan driver minifilter untuk operasi I/O ini. Tidak dapat FLT_PREOP_PENDING, FLT_PREOP_SYNCHRONIZE, atau FLT_PREOP_DISALLOW_FASTIO. Harus salah satu nilai FLT_PREOP_CALLBACK_STATUS berikut ini. Untuk informasi selengkapnya tentang efek nilai-nilai ini, lihat bagian Keterangan dari entri referensi untuk PFLT_PRE_OPERATION_CALLBACK.

Nilai	Makna
FLT_PREOP_COMPLETE	Driver minifilter sedang menyelesaikan operasi I/O. Manajer Filter tidak mengirim operasi I/O ke driver minifilter apa pun di bawah pemanggil atau ke sistem file. Manajer Filter hanya memanggil rutinitas panggilan balik pascaoperasi (PFLT_POST_OPERATION_CALLBACK) dari driver minifilter di atas pemanggil.
FLT_PREOP_SUCCESS_NO_CALLBACK	Driver minifilter mengembalikan kontrol operasi I/O ke Filter Manager. Manajer Filter tidak memanggil panggilan balik pascaoperasi yang sesuai, jika ada, selama penyelesaian I/O.
FLT_PREOP_SUCCESS_WITH_CALLBACK	Driver minifilter mengembalikan kontrol operasi I/O ke Filter Manager. Manajer Filter memanggil panggilan balik pascaoperasi yang sesuai selama penyelesaian I/O.

[in, optional] Context

Jika FLT_PREOP_SUCCESS_WITH_CALLBACK ditentukan untuk CallbackStatus, parameter ini adalah penunjuk konteks opsional untuk diteruskan ke rutinitas panggilan balik pascaoperasi yang sesuai. Jika FLT_PREOP_COMPLETE atau FLT_PREOP_SUCCESS_NO_CALLBACK ditentukan untuk CallbackStatus, parameter ini harus NULL.

Mengembalikan nilai

Tidak ada

Keterangan

Ketika panggilan balik praoperasi driver minifilter (PFLT_PRE_OPERATION_CALLBACK) rutin memposting operasi I/O ke antrean kerja dan mengembalikan FLT_PREOP_PENDING, Manajer Filter berhenti memproses operasi. Ketika operasi akhirnya dihapus antrean dan diproses, driver minifilter harus memanggil FltCompletePendedPreOperation untuk mengembalikan operasi ke Manajer Filter, yang kemudian melanjutkan pemrosesan seperti yang diarahkan oleh CallbackStatus yang ditentukan oleh driver minifilter.

Jika parameter CallbackStatus FLT_PREOP_COMPLETE, FltCompletePendedPreOperation dapat dipanggil di IRQL <= DISPATCH_LEVEL. Jika tidak, penelepon FltCompletePendedPreOperation harus berjalan di IRQL <= APC_LEVEL.