FsRtlLookupLargeMcbEntry-Funktion (ntifs.h)

Artikel
02/07/2025

Angesichts einer virtuellen Blocknummer (VBN) und eines Kartensteuerelementblocks (MCB) durchsucht die FsRtlLookupLargeMcbEntry Routine die MCB nach Zuordnungsinformationen, die dem angegebenen VBN entsprechen.

Syntax

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

Parameter

Mcb

Zeiger auf eine initialisierte MCB-Struktur.

Vbn

Zeiger auf den angeforderten VBN.

Lbn

Zeiger auf eine Variable, die den LBN empfängt, der LargeVbn- im Zuordnungseintrag zugeordnet ist, oder -1, wenn kein solcher LBN vorhanden ist. Dieser Parameter ist optional und kann NULL sein.

SectorCountFromLbn

Zeiger auf eine Variable, die die Anzahl der Sektoren empfängt, die LargeVbn- im Zuordnungslauf folgen. Dieser Parameter ist optional und kann NULL sein.

StartingLbn

Zeiger auf eine Variable, die den LBN erhält, der dem Anfang des Zuordnungslaufs entspricht, oder -1, wenn keine solche LBN vorhanden ist. Dieser Parameter ist optional und kann NULL sein.

SectorCountFromStartingLbn

Zeiger auf eine Variable, die die Anzahl der Sektoren in der Zuordnungsausführung empfängt. Dieser Parameter ist optional und kann NULL sein.

[out, optional] Index

Zeigen Sie auf eine Variable, die den Index der Zuordnungsausführung empfängt, die den VBN enthält. Dieser Parameter ist optional und kann NULL sein.

Rückgabewert

FsRtlLookupLargeMcbEntry TRUE zurück, wenn sich der angegebene VBN innerhalb des Bereichs von VBNs befindet, die vom MCB zugeordnet werden, andernfalls FALSE.

Bemerkungen

FsRtlLookupLargeMcbEntry sucht nach einem Zuordnungseintrag in der MCB, deren Ausführung den angegebenen VBN enthält.

Wenn eine solche Zuordnung vorhanden ist, liefert der Nachschlagevorgang positive Werte für die entsprechende LBN- und Sektoranzahl, und FsRtlLookupLargeMcbEntry gibt WAHR zurück.
Wenn keine solche Zuordnung vorhanden ist, aber der angegebene VBN niedriger als der höchste VBN ist, der vom MCB zugeordnet wird, wird dies als Loch in der Zuordnung bezeichnet. In diesem Fall gibt FsRtlLookupLargeMcbEntry weiterhin TRUE zurück, aber der Nachschlagevorgang liefert einen Wert von -1 für den LBN.
Wenn der angegebene VBN höher als der höchste VBN ist, der vom MCB zugeordnet ist oder wenn der MCB keine Zuordnungen enthält, gibt FsRtlLookupLargeMcbEntry FALSE zurück.

Die oberen 32 Bits des LBN werden ignoriert. Nur die unteren 32 Bit werden verwendet.