Fungsi FltCbdqDisable (fltkernel.h)

Artikel
02/29/2024

FltCbdqDisable menonaktifkan antrean data panggilan balik driver minifilter.

Sintaks

VOID FLTAPI FltCbdqDisable(
  [in, out] PFLT_CALLBACK_DATA_QUEUE Cbdq
);

Parameter

[in, out] Cbdq

Arahkan ke antrean data panggilan balik.

Nilai kembali

Tidak ada

Keterangan

FltCbdqDisable menonaktifkan antrean data panggilan balik sehingga tidak ada lagi item yang dapat ditambahkan ke dalamnya.

Driver minifilter dapat menggunakan rutinitas FltCbdqXxx untuk menerapkan antrean data panggilan balik untuk operasi I/O berbasis IRP. Dengan menggunakan rutinitas ini, pengemudi minifilter dapat membuat antrean mereka batal aman; sistem secara transparan menangani pembatalan I/O untuk driver minifilter.

Rutinitas FltCbdqXxx hanya dapat digunakan untuk operasi I/O berbasis IRP. Untuk menentukan apakah struktur data panggilan balik tertentu mewakili operasi I/O berbasis IRP, gunakan makro FLT_IS_IRP_OPERATION .

Driver minifilter biasanya memanggil FltCbdqDisable selama gangguan instans atau pembongkaran driver minifilter. Setelah memanggil rutinitas ini, driver minifilter harus kosong, atau menguras, antrean. Ini dapat dilakukan dengan memanggil FltCbdqRemoveNextIo berulang kali sampai tidak ada lagi item yang tersisa dalam antrean.

Lihat FltCbdqInitialize untuk detail tentang cara membuat antrean data panggilan balik. Gunakan FltCbdqInsertIo untuk menambahkan permintaan I/O ke antrean. Gunakan FltCbdqRemoveIo untuk menghapus permintaan I/O tertentu dari antrean, atau FltCbdqRemoveNextIo untuk menghapus permintaan I/O berikutnya yang tersedia.

Untuk mengaktifkan kembali antrean setelah menonaktifkannya, panggil FltCbdqEnable.

Jika antrean dilindungi oleh kunci putaran daripada objek mutex atau variabel sumber daya, pemanggil FltCbdqDisable dapat berjalan di IRQL <= DISPATCH_LEVEL. Jika mutex atau sumber daya digunakan, pemanggil harus berjalan di IRQL <= APC_LEVEL.