Fungsi FltGetTopInstance (fltkernel.h)

Artikel
02/26/2024

Rutinitas FltGetTopInstance mengembalikan penunjuk instans buram untuk instans driver minifilter yang terpasang di bagian atas tumpukan instans untuk volume tertentu.

Sintaks

NTSTATUS FLTAPI FltGetTopInstance(
  [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

FltGetTopInstance 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 atas tumpukan instans driver minifilter jika ketinggiannya lebih tinggi dari semua instans lain yang terpasang 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.

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