FsRtlLookupLargeMcbEntry-Funktion (ntifs.h)

Artikel
10/04/2023

Bei einer virtuellen Blocknummer (VBN) und einem Map Control Block (MCB) durchsucht die FsRtlLookupLargeMcbEntry-Routine den 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 solches 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 in der Zuordnungsausführung folgen. Dieser Parameter ist optional und kann NULL sein.

StartingLbn

Zeiger auf eine Variable, die den LBN empfängt, der dem Beginn der Zuordnungsausführung 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 von Sektoren in der Zuordnungsausführung empfängt. Dieser Parameter ist optional und kann NULL sein.

[out, optional] Index

Zeiger 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 gibt TRUE zurück, wenn sich der angegebene VBN innerhalb des Bereichs von VBNs befindet, die vom MCB zugeordnet werden, andernfalls FALSE.

Hinweise

FsRtlLookupLargeMcbEntry sucht nach einem Zuordnungseintrag im MCB, dessen Ausführung den angegebenen VBN enthält.

Wenn eine solche Zuordnung vorhanden ist, ergibt der Nachschlagevorgang positive Werte für die entsprechende LBN- und Sektoranzahl, und FsRtlLookupLargeMcbEntry gibt TRUE 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 ergibt den Wert -1 für den LBN.
Wenn der angegebene VBN höher als der höchste VBN ist, der vom MCB zugeordnet wird, oder wenn der MCB keine Zuordnungen enthält, gibt FsRtlLookupLargeMcbEntry FALSE zurück.

Die oberen 32 Bits des LBN werden ignoriert. Es werden nur die unteren 32 Bits verwendet.