FsRtlLookupLargeMcbEntry 函式 (ntifs.h)

發行項
02/26/2024

假設虛擬區塊編號 (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。

傳回值

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

備註

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

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

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