Fungsi FltGetLowerInstance (fltkernel.h)

Artikel
02/26/2024

Rutinitas FltGetLowerInstance mengembalikan penunjuk instans buram untuk instans driver minifilter bawah berikutnya, jika ada, yang dilampirkan di bawah instans driver minifilter tertentu pada volume yang sama.

Sintaks

NTSTATUS FLTAPI FltGetLowerInstance(
  [in]  PFLT_INSTANCE CurrentInstance,
  [out] PFLT_INSTANCE *LowerInstance
);

Parameter

[in] CurrentInstance

Penunjuk instans buram untuk instans driver minifilter tempat instans driver minifilter yang lebih rendah diminta.

[out] LowerInstance

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

Nilai kembali

FltGetLowerInstance mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai, seperti berikut ini:

Menampilkan kode	Deskripsi
STATUS_NO_MORE_ENTRIES	Tidak ditemukan instans driver minifilter yang lebih rendah. Ini adalah kode peringatan.

Keterangan

Satu instans dikatakan berada di bawah instans lain jika terpasang pada ketinggian yang lebih rendah pada volume yang sama. Istilah "ketinggian" mengacu pada posisi yang ditempati instans (atau harus menempati) 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.

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