MmPrefetchPages 함수(ntifs.h)

MmPrefetchPages 루틴은 최적의 방식으로 보조 스토리지에서 페이지 그룹을 읽습니다.

구문

NTSTATUS MmPrefetchPages(
  [in] ULONG      NumberOfLists,
  [in] PREAD_LIST *ReadLists
);

매개 변수

[in] NumberOfLists

ReadLists 매개 변수에 전달된 배열의 읽기 목록 수입니다.

[in] ReadLists

프리페치할 읽기 목록 배열에 대한 포인터입니다.

반환 값

MmPrefetchPages는 작업의 최종 완료 상태 나타내는 STATUS_SUCCESS 또는 적절한 오류 상태 반환합니다. 가능한 오류 상태 코드에는 다음이 포함됩니다.

반환 코드	설명
STATUS_INSUFFICIENT_RESOURCES	이 함수에 필요한 임시 버퍼를 할당할 수 없습니다.
STATUS_INVALID_PARAMETER_1	ReadLists의 섹션은 프리페치할 수 없거나(예: 물리적 또는 페이지 파일 기반 섹션) 잘못된 NumberOfLists 값이 제공되었습니다.

MmPrefetchPages는 성공에 대한 STATUS_SUCCESS 반환하며, 요청된 모든 페이지가 이미 메모리에 있으면 보조 스토리지에서 읽기가 필요하지 않음을 나타냅니다.

설명

MmPrefetchPages는 읽기 목록에 설명된 보조 스토리지에서 최적의 방식으로 페이지를 읽습니다. 호출자는 다양한 파일 개체 및 논리 블록 오프셋 목록을 작성하여 내부 페이지를 검사하는 MmPrefetchPages 함수에 전달하고, 아직 유효하지 않거나 전환 중인 페이지를 읽습니다. 더미 페이지를 사용하여 작은 간격을 메우는 단일 읽기로 페이지를 읽습니다. 간격이 "큰" 경우 별도의 읽기가 발급됩니다.

참고

파일이 프리페치되려면 section 개체 가 이미 있어야 합니다. ZwCreateSection을 호출하여 섹션 핸들을 가져올 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP
대상 플랫폼	유니버설
헤더	ntifs.h(Ntifs.h, Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 규정 준수 규칙	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)