Fungsi FsRtlInitializeLargeMcb (ntifs.h)

Artikel
02/26/2024

FsRtlInitializeLargeMcb rutin menginisialisasi struktur blok kontrol peta (MCB).

Sintaks

void FsRtlInitializeLargeMcb(
       PLARGE_MCB Mcb,
  [in] POOL_TYPE  PoolType
);

Parameter

Mcb

Arahkan ke struktur MCB yang dialokasikan penelepon untuk menginisialisasi.

[in] PoolType

Jenis kumpulan yang akan digunakan saat mengalokasikan penyimpanan internal tambahan untuk MCB. Salah satu dari berikut ini:

NonPagedPool
PagedPool
NonPagedPoolCacheAligned
PagedPoolCacheAligned

Jenis kumpulan NonPagedPoolMustSucceed dan NonPagedPoolCacheAlignedMustS sudah usang dan tidak boleh lagi digunakan.

Nilai kembali

Tidak ada

Keterangan

FsRtlInitializeLargeMcb menginisialisasi struktur blok kontrol peta (MCB). Sistem file menggunakan struktur MCB untuk memetakan nomor blok virtual (VBN) untuk file ke nomor blok logis (LBN) yang sesuai pada disk.

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

Sistem file harus memanggil FsRtlInitializeLargeMcb sebelum menggunakan rutinitas FsRtlXxxMcbYyy lainnya pada struktur MCB.

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