Fungsi FltGetUpperInstance (fltkernel.h)

Artikel
08/07/2023

Rutinitas FltGetUpperInstance mengembalikan penunjuk instans buram untuk instans driver minifilter yang lebih tinggi berikutnya, jika ada, yang terpasang di atas instans driver minifilter tertentu pada volume yang sama.

Sintaks

NTSTATUS FLTAPI FltGetUpperInstance(
  [in]  PFLT_INSTANCE CurrentInstance,
  [out] PFLT_INSTANCE *UpperInstance
);

Parameter

[in] CurrentInstance

Penunjuk instans buram untuk instans yang diminta instans yang lebih tinggi berikutnya.

[out] UpperInstance

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

Nilai kembali

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

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

Keterangan

Satu instans dikatakan berada di atas yang lain jika terpasang pada ketinggian yang lebih tinggi 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 dalam rentang 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.

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