Fungsi FltGetBottomInstance (fltkernel.h)

Artikel
02/29/2024

FltGetBottomInstance mengembalikan pointer instans buram untuk instans driver minifilter, jika ada, yang terpasang di bagian bawah tumpukan instans untuk volume tertentu.

Sintaks

NTSTATUS FLTAPI FltGetBottomInstance(
  [in]  PFLT_VOLUME   Volume,
  [out] PFLT_INSTANCE *Instance
);

Parameter

[in] Volume

Penunjuk buram untuk volume.

[out] Instance

Penunjuk ke variabel yang dialokasikan penelepon yang menerima penunjuk instans buram untuk instans bawah untuk volume ini. Parameter ini diperlukan dan tidak boleh NULL.

Nilai kembali

FltGetBottomInstance mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai seperti berikut ini:

Menampilkan kode	Deskripsi
STATUS_NO_MORE_ENTRIES	Tidak ada instans yang cocok yang ditemukan. Ini adalah kode peringatan.

Keterangan

Instans dikatakan berada di bagian bawah tumpukan instans driver minifilter jika ketinggiannya lebih rendah dari semua instans lain yang melekat pada volume yang sama. Istilah "ketinggian" mengacu pada posisi yang ditempati instans dalam tumpukan instans driver minifilter untuk volume. Semakin tinggi ketinggian, semakin jauh instans berasal dari sistem file dasar di tumpukan. Hanya satu instans yang dapat dilampirkan pada ketinggian tertentu pada volume tertentu.

Ketinggian ditentukan oleh string ketinggian, yang merupakan string Unicode yang dihitung yang terdiri dari satu atau beberapa digit desimal dari 0 hingga 9, dan dapat menyertakan satu titik desimal. Misalnya, "100.123456" dan "03333" adalah string ketinggian yang valid.

String "03333" mewakili ketinggian yang lebih tinggi daripada "100.123456". (Nol di awal dan akhir diabaikan.) Dengan kata lain, instans yang ketinggiannya adalah "03333" lebih jauh dari sistem file dasar daripada instans yang ketinggiannya adalah "100.123456". Namun, perbandingan ini hanya bermakna jika kedua instans dilampirkan ke volume yang sama.

FltGetBottomInstance menambahkan referensi rundown ke penunjuk instans buram yang dikembalikan dalam *Instans. Ketika pointer ini tidak lagi diperlukan, pemanggil harus melepaskannya dengan memanggil FltObjectDereference. Dengan demikian setiap panggilan yang berhasil ke FltGetBottomInstance harus dicocokkan dengan panggilan berikutnya ke FltObjectDereference.