Fungsi FltGetSectionContext (fltkernel.h)

  • Artikel

Rutinitas FltGetSectionContext mengambil konteks bagian yang dibuat untuk aliran file oleh instans driver minifilter tertentu.

Sintaks

NTSTATUS FLTAPI FltGetSectionContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PFILE_OBJECT  FileObject,
  [out] PFLT_CONTEXT  *Context
);

Parameter

[in] Instance

Penunjuk instans buram untuk instans driver minifilter yang konteksnya akan diambil.

[in] FileObject

Penunjuk ke objek file untuk aliran.

[out] Context

Penunjuk ke variabel yang dialokasikan pemanggil yang menerima alamat konteks. Parameter ini diperlukan dan tidak dapat diatur ke NULL.

Nilai kembali

FltGetSectionContext mengembalikan STATUS_SUCCESS ketika berhasil mengembalikan konteks bagian yang diminta. Jika tidak, nilai NTSTATUS yang sesuai akan ditampilkan, seperti salah satu hal berikut ini:

Menampilkan kode Deskripsi
STATUS_NOT_FOUND Tidak ada konteks yang cocok yang ditemukan pada file ini saat ini, jadi FltMgr mengatur Konteks ke NULL_CONTEXT. Ini adalah kode kesalahan.
STATUS_NOT_SUPPORTED Volume yang dilampirkan ke instans ini tidak mendukung konteks bagian. Ini adalah kode kesalahan.

Keterangan

Untuk informasi selengkapnya tentang konteks, lihat Tentang konteks minifilter.

FltGetSectionContext mengambil konteks bagian yang dibuat untuk aliran file oleh instans driver minifilter tertentu. Konteks bagian dibuat dengan memanggil FltCreateSectionForDataScan.

FltGetSectionContext menambah jumlah referensi pada konteks yang ditunjuk parameter Konteks . Ketika penunjuk konteks ini tidak lagi diperlukan, pemanggil harus mengurangi jumlah referensinya dengan memanggil FltReleaseContext. Dengan demikian setiap panggilan yang berhasil ke FltGetSectionContext harus dicocokkan dengan panggilan berikutnya ke FltReleaseContext.

Untuk mengalokasikan konteks baru, panggil FltAllocateContext.

Minifilter tidak boleh secara eksplisit menghapus konteks bagian yang diteruskan ke FltCreateSectionForDataScan. Konteks bagian dibatalkan alokasinya dan dihapus dari aliran dengan memanggil FltCloseSectionForDataScan dalam kasus ini.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8
Target Platform Universal
Header fltkernel.h (termasuk Fltkernel.h)
Pustaka FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

Lihat juga

FltAllocateContext

FltCloseSectionForDataScan

FltCreateSectionForDataScan

FltReleaseContext