Fungsi FltCompareInstanceAltitudes (fltkernel.h)

Artikel
02/29/2024

FltCompareInstanceAltitudes membandingkan ketinggian dua instans driver minifilter.

Sintaks

LONG FLTAPI FltCompareInstanceAltitudes(
  [in] PFLT_INSTANCE Instance1,
  [in] PFLT_INSTANCE Instance2
);

Parameter

[in] Instance1

Arahkan ke instans pertama.

[in] Instance2

Arahkan ke instans kedua.

Nilai kembali

FltCompareInstanceAltitudes mengembalikan nilai bertanda tangan yang memberikan hasil perbandingan sebagai berikut:

Menampilkan kode	Deskripsi
Nol	Instance1 dilampirkan pada ketinggian yang sama dengan Instance2. Ini hanya dapat terjadi jika Instance1 dan Instance2 dilampirkan ke volume yang berbeda atau jika Instance1 dan Instance2 adalah pointer ke instans yang sama.
Kurang dari nol	Instance1 dilampirkan pada ketinggian yang lebih rendah dari Instance2.
Lebih besar dari nol	Instance1 dilampirkan pada ketinggian yang lebih tinggi daripada Instance2.

Keterangan

Instans driver minifilter yang dirujuk Instance1 dan Instance2 dapat menjadi instans driver minifilter yang sama atau driver minifilter yang berbeda. Namun, mereka harus dilampirkan ke volume yang sama jika hasil yang dikembalikan oleh FltCompareInstanceAltitudes adalah bermakna.

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 terhitung yang terdiri dari satu atau beberapa digit desimal dari 0 hingga 9; string 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 depan dan di belakang 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.

Untuk melampirkan instans driver minifilter ke volume, panggil FltAttachVolume atau FltAttachVolumeAtAltitude.

Untuk melepaskan instans driver minifilter dari volume, panggil FltDetachVolume.