Fungsi FsRtlLookupLargeMcbEntry (ntifs.h)

Artikel
02/26/2024

Mengingat nomor blok virtual (VBN) dan blok kontrol peta (MCB), rutinitas FsRtlLookupLargeMcbEntry mencari MCB untuk informasi pemetaan yang sesuai dengan VBN yang ditentukan.

Sintaks

BOOLEAN FsRtlLookupLargeMcbEntry(
                  PLARGE_MCB Mcb,
                  LONGLONG   Vbn,
                  PLONGLONG  Lbn,
                  PLONGLONG  SectorCountFromLbn,
                  PLONGLONG  StartingLbn,
                  PLONGLONG  SectorCountFromStartingLbn,
  [out, optional] PULONG     Index
);

Parameter

Mcb

Penunjuk ke struktur MCB yang diinisialisasi.

Vbn

Arahkan ke VBN yang diminta.

Lbn

Penunjuk ke variabel yang menerima LBN yang dipetakan ke LargeVbn dalam entri pemetaan, atau -1 jika tidak ada LBN tersebut. Parameter ini bersifat opsional dan dapat berupa NULL.

SectorCountFromLbn

Penunjuk ke variabel yang menerima jumlah sektor yang mengikuti LargeVbn dalam eksekusi pemetaan. Parameter ini bersifat opsional dan dapat berupa NULL.

StartingLbn

Arahkan ke variabel yang menerima LBN yang sesuai dengan awal eksekusi pemetaan, atau -1 jika tidak ada LBN seperti itu. Parameter ini bersifat opsional dan dapat berupa NULL.

SectorCountFromStartingLbn

Penunjuk ke variabel yang menerima jumlah sektor dalam pemetaan yang dijalankan. Parameter ini bersifat opsional dan dapat berupa NULL.

[out, optional] Index

Penunjuk ke variabel yang menerima indeks eksekusi pemetaan yang berisi VBN. Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

FsRtlLookupLargeMcbEntry mengembalikan TRUE jika VBN yang ditentukan berada dalam rentang VPN yang dipetakan oleh MCB, salah jika tidak.

Keterangan

FsRtlLookupLargeMcbEntry mencari entri pemetaan di MCB yang eksekusinya menyertakan VBN yang ditentukan.

Jika pemetaan seperti itu ada, operasi pencarian menghasilkan nilai positif untuk LBN dan jumlah sektor yang sesuai, dan FsRtlLookupLargeMcbEntry mengembalikan TRUE.
Jika tidak ada pemetaan seperti itu, tetapi VBN yang ditentukan lebih rendah dari VBN tertinggi yang dipetakan oleh MCB, ini disebut sebagai lubang dalam pemetaan. Dalam hal ini, FsRtlLookupLargeMcbEntry masih mengembalikan TRUE, tetapi operasi pencarian menghasilkan nilai -1 untuk LBN.
Jika VBN yang ditentukan lebih tinggi dari VBN tertinggi yang dipetakan oleh MCB, atau jika MCB tidak berisi pemetaan, FsRtlLookupLargeMcbEntry mengembalikan FALSE.

32 bit atas LBN diabaikan. Hanya 32 bit yang lebih rendah yang digunakan.