Fungsi FltReleaseContextsEx (fltkernel.h)

FltReleaseContextsEx merilis setiap konteks dalam struktur FLT_RELATED_CONTEXTS_EX tertentu.

Sintaks

VOID FLTAPI FltReleaseContextsEx(
  [in] SIZE_T                   ContextsSize,
  [in] PFLT_RELATED_CONTEXTS_EX Contexts
);

Parameter

[in] ContextsSize

Ukuran, dalam byte, dari struktur FLT_RELATED_CONTEXTS_EX yang ditujukkan oleh Konteks. Atur ke sizeof(FLT_RELATED_CONTEXTS_EX).

[in] Contexts

Arahkan ke struktur FLT_RELATED_CONTEXTS_EX .

Nilai kembali

Tidak ada

Keterangan

Untuk informasi selengkapnya tentang konteks, lihat Tentang konteks minifilter.

FltReleaseContextsEx mengurangi jumlah referensi pada semua konteks dalam struktur FLT_RELATED_CONTEXTS_EX dan mengatur semua anggota struktur ke NULL_CONTEXT.

Untuk mendapatkan struktur FLT_RELATED_CONTEXTS_EX untuk driver minifilter tertentu untuk permintaan I/O tertentu, panggil FltGetContextsEx.

Untuk informasi selengkapnya tentang penghitungan referensi konteks, lihat Mereferensikan Konteks.

Penelepon FltReleaseContextsEx harus berjalan di IRQL <= DISPATCH_LEVEL jika semua konteks dialokasikan dari kumpulan yang tidak disebarkan. Jika ada konteks yang dialokasikan dari kumpulan halaman, penelepon harus berjalan di IRQL <= APC_LEVEL.

Ketika jumlah referensi setiap konteks mencapai nol, konteks segera dikosongkan jika pemanggil berjalan di IRQL <= APC_LEVEL. Jika pemanggil berjalan di IRQL DISPATCH_LEVEL, item kerja dijadwalkan untuk membebaskan konteks.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 8.
Target Platform Universal
Header fltkernel.h (termasuk Fltkernel.h)
Pustaka FltMgr.lib
DLL Fltmgr.sys
IRQL Lihat bagian Keterangan.

Lihat juga

FLT_CONTEXT_REGISTRATION

FLT_RELATED_CONTEXTS_EX

FltAllocateContext

FltGetContextsEx

FltReleaseContext