Fungsi FsRtlAddLargeMcbEntry (ntifs.h)

Artikel
02/29/2024

Rutinitas FsRtlAddLargeMcbEntry menambahkan pemetaan baru ke blok kontrol peta (MCB) yang ada.

Sintaks

BOOLEAN FsRtlAddLargeMcbEntry(
  PLARGE_MCB Mcb,
  LONGLONG   Vbn,
  LONGLONG   Lbn,
  LONGLONG   SectorCount
);

Parameter

Mcb

Penunjuk ke struktur MCB yang diinisialisasi.

Vbn

Memulai nomor blok virtual (VBN) dari pemetaan baru yang dijalankan untuk ditambahkan ke MCB.

Lbn

Nomor blok logis (LBN) di mana LargeVbn akan dipetakan.

SectorCount

Jumlah sektor dalam eksekusi pemetaan baru.

Nilai kembali

FsRtlAddLargeMcbEntry mengembalikan TRUE jika pemetaan baru berhasil ditambahkan ke MCB, FALSE jika tidak.

Keterangan

FsRtlAddLargeMcbEntry menambahkan pemetaan baru ke blok kontrol peta (MCB) yang ada. Sistem file menggunakan struktur MCB untuk memetakan nomor blok virtual (VBN) untuk file ke nomor blok logis (LBN) yang sesuai pada disk.

Catatan 32 bit atas LBN diabaikan, tetapi harus diatur ke nol. Hanya 32 bit yang lebih rendah yang digunakan.

Jika pemetaan baru yang dijalankan untuk ditambahkan tumpang tindih dengan eksekusi pemetaan yang ada, FsRtlAddLargeMcbEntry menggabungkannya ke dalam satu eksekusi pemetaan.

Jika kegagalan alokasi kumpulan terjadi, FsRtlAddLargeMcbEntry menimbulkan pengecualian STATUS_INSUFFICIENT_RESOURCES. Untuk mendapatkan kontrol jika kegagalan alokasi kumpulan ini terjadi, driver harus membungkus panggilan ke FsRtlAddLargeMcbEntry dalam pernyataan try-except atau try-finally .

Untuk menginisialisasi MCB, panggil FsRtlInitializeLargeMcb. Untuk membatalkan inisialisasi MCB, panggil FsRtlUninitializeLargeMcb.