FsRtlInitializeLargeMcb - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// ntifs.h

VOID FsRtlInitializeLargeMcb(
       PLARGE_MCB Mcb,
  [in] POOL_TYPE  PoolType
);
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-ntifs-_fsrtl_advanced_fcb_header-fsrtlinitializelargemcb)

FsRtlInitializeLargeMcb function

Description

The FsRtlInitializeLargeMcb routine initializes a map control block (MCB) structure.

Parameters

Mcb

Pointer to a caller-allocated MCB structure to initialize.

PoolType [in]

Type of pool to use when allocating additional internal storage for the MCB. One of the following:

The NonPagedPoolMustSucceed and NonPagedPoolCacheAlignedMustS pool types are obsolete and should no longer be used.

Remarks

FsRtlInitializeLargeMcb initializes a map control block (MCB) structure. File systems use MCB structures to map virtual block numbers (VBN) for a file to the corresponding logical block numbers (LBN) on disk.

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

File systems must call FsRtlInitializeLargeMcb before using any other FsRtlXxxMcb*Yyy* routines on the MCB structure.

If a pool allocation failure occurs, FsRtlInitializeLargeMcb raises a STATUS_INSUFFICIENT_RESOURCES exception. To gain control if this pool allocation failure occurs, the driver should wrap the call to FsRtlInitializeLargeMcb in a try-except or try-finally statement.

See also

FsRtlAddLargeMcbEntry

FsRtlGetNextLargeMcbEntry

FsRtlLookupLargeMcbEntry

FsRtlLookupLastLargeMcbEntry

FsRtlLookupLastLargeMcbEntryAndIndex

FsRtlNumberOfRunsInLargeMcb

FsRtlRemoveLargeMcbEntry

FsRtlSplitLargeMcb

FsRtlTruncateLargeMcb

FsRtlUninitializeLargeMcb