FsRtlLookupLargeMcbEntry 함수(ntifs.h)

아티클
02/07/2025

VBN(가상 블록 번호) 및 맵 제어 블록(MCB)이 지정된 경우 FsRtlookupLargeMcbEntry 루틴은 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일 수 있습니다.

반환 값

FsRtlLookupLargeMcbEntry 지정된 VBN이 MCB에 의해 매핑된 VBN 범위 내에 있으면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.

발언

FsRtlLookupLargeMcbEntry 지정된 VBN을 포함하는 실행이 MCB에서 매핑 항목을 검색합니다.

이러한 매핑이 있는 경우 조회 작업은 해당 LBN 및 섹터 수에 대해 양수 값을 생성하고 FsRtlookupLargeMcbEntry TRUE를 반환합니다.
이러한 매핑이 없지만 지정된 VBN이 MCB에 의해 매핑된 가장 높은 VBN보다 낮은 경우 이를 매핑의 구멍이라고 합니다. 이 경우 FsRtllookupLargeMcbEntry 여전히 TRUE를 반환하지만 조회 작업은 LBN에 대한 -1 값을 생성합니다.
지정된 VBN이 MCB에 의해 매핑된 가장 높은 VBN보다 높거나 MCB에 매핑이 없는 경우 FsRtlLookupLargeMcbEntry FALSE를 반환합니다.

LBN의 상위 32비트가 무시됩니다. 하위 32비트만 사용됩니다.