FsRtlAddLargeMcbEntry 函式（ntifs.h）

發行項
12/20/2024

FsRtlAddLargeMcbEntry 例程會將新的對應新增至現有的地圖控制區塊（MCB）。

語法

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

參數

Mcb

初始化MCB結構的指標。

Vbn

啟動要新增至MCB之新對應執行的虛擬區塊編號（VBN）。

Lbn

要對應 LargeVbn 的邏輯區塊編號（LBN）。

SectorCount

新對應執行中的扇區數目。

傳回值

FsRtlAddLargeMcbEntry 如果成功將新的對應新增至 MCB，FALSE，則會傳 回 TRUE。

言論

FsRtlAddLargeMcbEntry 將新的對應新增至現有的地圖控件區塊（MCB）。文件系統會使用MCB結構，將虛擬區塊編號（VBN）對應至磁碟上對應的邏輯區塊編號（LBN）。

附注會忽略 LBN 的上層 32 位，但必須設定為零。只會使用較低的32位。

如果要新增的新對應執行與現有的對應執行重疊，FsRtlAddLargeMcbEntry 將它們合併成單一對應執行。

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

若要初始化 MCB，請呼叫 FsRtlInitializeLargeMcb。若要取消初始化 MCB，請呼叫 FsRtlUninitializeLargeMcb。