FsRtlLookupLastLargeMcbEntryAndIndex function (ntifs.h)

The FsRtlLookupLastLargeMcbEntryAndIndex routine retrieves the last mapping entry stored in a given map control block (MCB).

Syntax

BOOLEAN FsRtlLookupLastLargeMcbEntryAndIndex(
  [in]  PLARGE_MCB OpaqueMcb,
  [out] PLONGLONG  LargeVbn,
  [out] PLONGLONG  LargeLbn,
  [out] PULONG     Index
);

Parameters

[in] OpaqueMcb

Pointer to an initialized MCB structure to be searched.

[out] LargeVbn

Pointer to a variable that receives the last virtual block number (VBN) that was mapped.

[out] LargeLbn

Pointer to a variable that receives the logical block number (LBN) that is mapped to the VBN pointed to by LargeVbn, or -1 if no such LBN exists.

[out] Index

Pointer to a variable that receives the index of the last run in the MCB.

Return value

FsRtlLookupLastLargeMcbEntryAndIndex returns FALSE if the MCB contains no mapping entries, FALSE otherwise.

Remarks

FsRtlLookupLastLargeMcbEntryAndIndex searches for the last mapping of the last run in the MCB:

• If the MCB contains no mappings, FsRtlLookupLastLargeMcbEntryAndIndex returns FALSE.

• If the last mapping is a hole, FsRtlLookupLastLargeMcbEntryAndIndex returns FALSE, but the lookup operation yields a value of -1 for the LBN.

• If the last mapping is not a hole, the lookup operation yields a positive value for the LBN, and FsRtlLookupLastLargeMcbEntryAndIndex returns FALSE.

The upper 32 bits of the LBN are ignored. Only the lower 32 bits are used.

Requirements

See also

FsRtlAddLargeMcbEntry

FsRtlGetNextLargeMcbEntry

FsRtlInitializeLargeMcb

FsRtlLookupLastLargeMcbEntry

FsRtlNumberOfRunsInLargeMcb

FsRtlRemoveLargeMcbEntry

FsRtlSplitLargeMcb

FsRtlTruncateLargeMcb

FsRtlUninitializeLargeMcb