FsRtlLookupLargeMcbEntry 函式（ntifs.h）

發行項
02/07/2025

假設虛擬區塊編號（VBN）和地圖控制區塊（MCB），FsRtlLookupLargeMcbEntry 例程會搜尋 MCB 以取得對應到指定 VBN 的對應資訊。

語法

BOOLEAN FsRtlLookupLargeMcbEntry(
                  PLARGE_MCB Mcb,
                  LONGLONG   Vbn,
                  PLONGLONG  Lbn,
                  PLONGLONG  SectorCountFromLbn,
                  PLONGLONG  StartingLbn,
                  PLONGLONG  SectorCountFromStartingLbn,
  [out, optional] PULONG     Index
);

參數

Mcb

初始化MCB結構的指標。

Vbn

所要求 VBN 的指標。

Lbn

接收對應項目中對應至 LargeVbn 之 LBN 的變數指標，如果不存在這類 LBN，則為 -1。這個參數是選擇性的，而且可以是 NULL。

SectorCountFromLbn

變數的指標，這個變數會接收對應執行中 LargeVbn 之後的扇區數目。這個參數是選擇性的，而且可以是 NULL。

StartingLbn

接收對應執行開始之 LBN 的變數指標，如果不存在這類 LBN，則為 -1。這個參數是選擇性的，而且可以是 NULL。

SectorCountFromStartingLbn

在對應執行中接收扇區數目的變數指標。這個參數是選擇性的，而且可以是 NULL。

[out, optional] Index

接收包含 VBN 之對應執行索引的變數指標。這個參數是選擇性的，而且可以是 NULL。

傳回值

FsRtlLookupLargeMcbEntry 如果指定的 VBN 位於 MCB 所對應的 VBN 範圍內，則傳回 TRUE，否則為 FALSE。

言論

FsRtlLookupLargeMcbEntry 搜尋 MCB 中執行包含指定 VBN 的對應專案。

如果存在這類對應，查閱作業會產生對應 LBN 和扇區計數的正值，FsRtlLookupLargeMcbEntry 傳回 TRUE。
如果不存在這類對應，但指定的 VBN 低於MCB所對應的最高 VBN，這稱為對應中的一個洞。在此情況下，FsRtlLookupLargeMcbEntry 仍然會傳回 TRUE，但查閱作業會產生 LBN -1 值。
如果指定的 VBN 高於 MCB 所對應的最高 VBN，或 MCB 不包含任何對應，FsRtlLookupLargeMcbEntry 會傳回 FALSE。

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