FsRtlInitializeLargeMcb 函式 (ntifs.h)

發行項
03/01/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 (VBN) 虛擬區塊編號對應至磁碟上的對應邏輯區塊編號 (LBN) 。

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

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

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