FsRtlRemoveLargeMcbEntry 函式 (ntifs.h)

發行項
03/01/2024

FsRtlRemoveLargeMcbEntry 例程會從地圖控件區塊中移除一或多個對應， (MCB) 。

語法

void FsRtlRemoveLargeMcbEntry(
  PLARGE_MCB Mcb,
  LONGLONG   Vbn,
  LONGLONG   SectorCount
);

參數

Mcb

MCB 結構的指標。

Vbn

起始虛擬區塊編號 (VBN) 要從MCB中移除對應的範圍。

SectorCount

要移除對應之範圍中的 (VBN) 扇區數目。

傳回值

無

備註

FsRtlRemoveLargeMcbEntry 會移除 MCB 中 VBN 與 LBN 的所有對應，這些對應落在以 *LargeVbn 開頭的 VBN 範圍內，並以 *LargeVbn + LargeSectorCount - 1) (結尾。

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

會忽略對應之間的漏洞 (間距) 。

如果要移除的 VBN 範圍包含MCB中對應的最高 VBN，則會據以調整MCB的 PairCount 成員。

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