Fungsi FltGetVolumeContext (fltkernel.h)

Artikel
02/29/2024

Rutinitas FltGetVolumeContext mengambil konteks yang ditetapkan untuk volume oleh driver minifilter tertentu.

Sintaks

NTSTATUS FLTAPI FltGetVolumeContext(
  [in]  PFLT_FILTER  Filter,
  [in]  PFLT_VOLUME  Volume,
  [out] PFLT_CONTEXT *Context
);

Parameter

[in] Filter

Penunjuk filter buram untuk pemanggil. Parameter ini diperlukan dan tidak boleh NULL.

[in] Volume

Penunjuk buram untuk volume yang konteksnya sedang diambil. Parameter ini diperlukan dan tidak boleh NULL.

[out] Context

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

Nilai kembali

FltGetVolumeContext mengembalikan STATUS_SUCCESS ketika berhasil mengembalikan konteks yang diminta. Jika tidak, ia mengembalikan nilai NTSTATUS yang sesuai seperti 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.

Keterangan

Untuk informasi selengkapnya tentang konteks, lihat Tentang konteks minifilter.

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

Untuk mengatur konteks volume, panggil FltSetVolumeContext.

Untuk mengalokasikan konteks baru, panggil FltAllocateContext.

Untuk menghapus konteks volume, panggil FltDeleteVolumeContext atau FltDeleteContext.