Fungsi FltDeleteStreamContext (fltkernel.h)
FltDeleteStreamContext menghapus konteks yang telah ditetapkan instans driver minifilter tertentu untuk aliran tertentu dan menandai konteks penghapusan.
Sintaks
NTSTATUS FLTAPI FltDeleteStreamContext(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[out] PFLT_CONTEXT *OldContext
);
Parameter
[in] Instance
Penunjuk instans buram untuk instans driver minifilter yang konteksnya akan dihapus dari daftar konteks yang dilampirkan ke aliran file.
[in] FileObject
Penunjuk ke objek file untuk aliran file.
[out] OldContext
Penunjuk ke variabel yang dialokasikan pemanggil yang menerima alamat konteks yang dihapus. Parameter ini bersifat opsional dan dapat berupa NULL. Jika OldContext bukan NULL dan tidak menunjuk ke NULL_CONTEXT, pemanggil bertanggung jawab untuk memanggil FltReleaseContext untuk merilis konteks ini ketika tidak lagi diperlukan.
Nilai kembali
FltDeleteStreamContext mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai seperti salah satu hal berikut ini:
Menampilkan kode | Deskripsi |
---|---|
STATUS_FLT_DELETING_OBJECT | Instans yang ditentukan sedang dikoyak. Ini adalah kode kesalahan. |
STATUS_NOT_FOUND | Tidak ditemukan konteks yang cocok. Ini adalah kode kesalahan. |
STATUS_NOT_SUPPORTED | Sistem file tidak mendukung konteks per aliran untuk aliran file ini. Ini adalah kode kesalahan. |
Keterangan
Untuk informasi selengkapnya tentang konteks, lihat Tentang konteks minifilter.
Karena konteks dihitung referensi, biasanya tidak perlu bagi driver minifilter untuk memanggil rutinitas seperti FltDeleteStreamContext untuk secara eksplisit menghapus konteks.
Driver minifilter memanggil FltDeleteStreamContext untuk menghapus konteks dari aliran file dan menandai konteks penghapusan. Konteks biasanya segera dikosongkan kecuali ada referensi luar biasa di dalamnya (misalnya, karena konteksnya masih digunakan oleh utas lain).
Untuk mengalokasikan konteks baru, panggil FltAllocateContext.
Untuk mendapatkan konteks streaming, panggil FltGetStreamContext.
Untuk mengatur konteks streaming, panggil FltSetStreamContext.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Header | fltkernel.h (termasuk Fltkernel.h) |
Pustaka | FltMgr.lib |
IRQL | <= APC_LEVEL |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk