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 |