FsRtlInitializeLargeMcb 函式（ntifs.h）

發行項
12/21/2024

FsRtlInitializeLargeMcb 例程會初始化地圖控制區塊（MCB）結構。

語法

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

參數

Mcb

要初始化之呼叫端配置的MCB結構的指標。

[in] PoolType

配置 MCB 其他內部記憶體時要使用的集區類型。下列其中一項：

NonPagedPool
PagedPool
NonPagedPoolCacheAligned
PagedPoolCacheAligned

NonPagedPoolMustSucceed 和 NonPagedPoolCacheAlignedMustS 集區類型已過時，不應再使用。

傳回值

沒有

言論

FsRtlInitializeLargeMcb 初始化地圖控制區塊（MCB）結構。文件系統會使用MCB結構，將虛擬區塊編號（VBN）對應至磁碟上對應的邏輯區塊編號（LBN）。

會忽略 LBN 的上層 32 位。只會使用較低的32位。

文件系統必須先呼叫 FsRtlInitializeLargeMcb，才能在 MCB 結構上使用任何其他 FsRtlXxxMcbYyy 例程。

如果集區配置失敗，FsRtlInitializeLargeMcb 引發STATUS_INSUFFICIENT_RESOURCES例外狀況。若要控制此集區配置失敗是否發生，驅動程式應該在 try-except 或 try-finally 語句中包裝呼叫 FsRtlInitializeLargeMcb。