FsRtlLookupLargeMcbEntry 함수(ntifs.h)

아티클
02/29/2024

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

반환 값

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

설명

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

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

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