MapViewOfFile2 함수(memoryapi.h)

파일 또는 페이지 파일 기반 섹션의 보기를 지정된 프로세스의 주소 공간에 매핑합니다.

구문

PVOID MapViewOfFile2(
  [in]           HANDLE  FileMappingHandle,
  [in]           HANDLE  ProcessHandle,
  [in]           ULONG64 Offset,
  [in, optional] PVOID   BaseAddress,
  [in]           SIZE_T  ViewSize,
  [in]           ULONG   AllocationType,
  [in]           ULONG   PageProtection
);

매개 변수

[in] FileMappingHandle

지정된 프로세스의 주소 공간에 매핑할 섹션에 대한 HANDLE 입니다.

[in] ProcessHandle

섹션을 매핑할 프로세스에 대한 HANDLE 입니다. 핸들에는 PROCESS_VM_OPERATION 액세스 마스크가 있어야 합니다.

[in] Offset

섹션 시작 부분의 오프셋입니다. 64k 정렬되어야 합니다.

[in, optional] BaseAddress

뷰의 원하는 기본 주소입니다. 주소는 가장 가까운 64k 경계로 반올림됩니다. 이 매개 변수가 NULL이면 시스템에서 기본 주소를 선택합니다.

[in] ViewSize

매핑할 바이트 수입니다. 값 0은 전체 섹션을 매핑하도록 지정합니다.

[in] AllocationType

할당 유형입니다. 이 매개 변수는 0 또는 다음 상수 값 중 하나일 수 있습니다.

• MEM_RESERVE - 예약된 보기를 매핑합니다.
• MEM_LARGE_PAGES - 큰 페이지 보기를 매핑합니다. 이 플래그는 큰 페이지 지원을 사용하여 뷰를 매핑해야 한다고 지정합니다. 보기의 크기는 GetLargePageMinimum 함수에서 보고하는 큰 페이지 크기의 배수여야 하며 파일 매핑 개체는 SEC_LARGE_PAGES 옵션을 사용하여 만들어야 합니다. BaseAddress 매개 변수에 null이 아닌 값을 제공하는 경우 값은 GetLargePageMinimum의 배수여야 합니다.

[in] PageProtection

원하는 페이지 보호입니다.

SEC_IMAGE 특성으로 만든 파일 매핑 개체의 경우 PageProtection 매개 변수는 효과가 없으며 PAGE_READONLY 같은 유효한 값으로 설정해야 합니다.

반환 값

성공한 경우 매핑된 뷰의 기본 주소를 반환합니다. 그렇지 않으면 GetLastError를 사용하여 사용할 수 상태 NULL 및 확장 오류를 반환합니다.

설명

이 함수는 헤더에서 인라인 함수로 구현되며 내보내기 라이브러리 또는 DLL에서 찾을 수 없습니다. 마지막 매개 변수가 로 설정된 MapViewOfFileNuma2 를 호출하는 것과 NUMA_NO_PREFERRED_NODE동일합니다.

요구 사항

지원되는 최소 클라이언트	Windows 10 버전 1703 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	memoryapi.h(Windows.h, Memoryapi.h 포함)
라이브러리	onecore.lib
DLL	Kernel32.dll

참고 항목

MapViewOfFile

MapViewOfFileNuma2