MapViewOfFileEx 함수(memoryapi.h)

호출 프로세스의 주소 공간에 파일 매핑 보기를 매핑합니다. 호출자는 필요에 따라 보기에 대해 제안된 기본 메모리 주소를 지정할 수 있습니다.

실제 메모리에 대한 NUMA 노드를 지정하려면 MapViewOfFileExNuma를 참조하세요.

구문

LPVOID MapViewOfFileEx(
  [in]           HANDLE hFileMappingObject,
  [in]           DWORD  dwDesiredAccess,
  [in]           DWORD  dwFileOffsetHigh,
  [in]           DWORD  dwFileOffsetLow,
  [in]           SIZE_T dwNumberOfBytesToMap,
  [in, optional] LPVOID lpBaseAddress
);

매개 변수

[in] hFileMappingObject

파일 매핑 개체에 대한 핸들입니다. CreateFileMappingOpenFileMapping 함수는 이 핸들을 반환합니다.

[in] dwDesiredAccess

페이지의 페이지 보호를 결정하는 파일 매핑 개체에 대한 액세스 유형입니다. 이 매개 변수는 다음 값 중 하나이거나 적절한 경우 여러 값의 비트 OR 조합일 수 있습니다.

의미
FILE_MAP_ALL_ACCESS
파일의 읽기/쓰기 보기가 매핑됩니다. 파일 매핑 개체는 PAGE_READWRITE 또는PAGE_EXECUTE_READWRITE 보호를 사용하여 만들어졌어야 합니다.

MapViewOfFileEx 함수와 함께 사용하는 경우 FILE_MAP_ALL_ACCESSFILE_MAP_WRITE 동일합니다.

FILE_MAP_READ
파일의 읽기 전용 보기가 매핑됩니다. 파일 뷰에 쓰려고 시도하면 액세스 위반이 발생합니다.

파일 매핑 개체는 PAGE_READONLY, PAGE_READWRITE, PAGE_EXECUTE_READ또는PAGE_EXECUTE_READWRITE 보호를 사용하여 만들어졌어야 합니다.

FILE_MAP_WRITE
파일의 읽기/쓰기 보기가 매핑됩니다. 파일 매핑 개체는 PAGE_READWRITE 또는PAGE_EXECUTE_READWRITE 보호를 사용하여 만들어졌어야 합니다.

MapViewOfFileEx와 함께 사용하는 경우(FILE_MAP_WRITE | FILE_MAP_READ) 및 FILE_MAP_ALL_ACCESSFILE_MAP_WRITE 동일합니다.

 

비트 OR을 사용하여 위의 값을 이러한 값과 결합할 수 있습니다.

의미
FILE_MAP_COPY
파일의 쓰기용 복사 보기가 매핑됩니다. 파일 매핑 개체는 PAGE_READONLY, PAGE_READ_EXECUTE, PAGE_WRITECOPY, PAGE_EXECUTE_WRITECOPY, PAGE_READWRITE 또는 PAGE_EXECUTE_READWRITE 보호를 사용하여 만들어졌어야 합니다.

프로세스에서 쓰기 복사 페이지에 쓰면 시스템에서 원본 페이지를 프로세스에 비공개인 새 페이지로 복사합니다. 새 페이지는 페이징 파일에서 백업됩니다. 새 페이지의 보호는 쓰기 중 복사에서 읽기/쓰기로 변경됩니다.

쓰기용 복사 액세스를 지정하면 호출 프로세스가 보기의 모든 페이지에 쓸 수 있으므로 모든 페이지를 비공개로 만들 수 있으므로 전체 보기에 대한 시스템 및 프로세스 커밋 요금이 청구됩니다. 새 페이지의 내용은 원래 파일에 다시 기록되지 않으며 보기가 매핑되지 않은 경우 손실됩니다.

FILE_MAP_LARGE_PAGES
Windows 10 버전 1703부터 이 플래그는 큰 페이지 지원을 사용하여 보기를 매핑해야 한다고 지정합니다. 보기의 크기는 GetLargePageMinimum 함수에서 보고한 큰 페이지 크기의 배수여야 하며 파일 매핑 개체는 SEC_LARGE_PAGES 옵션을 사용하여 만들어야 합니다. lpBaseAddress에 null이 아닌 값을 제공하는 경우 값은 GetLargePageMinimum의 배수여야 합니다.
FILE_MAP_EXECUTE
파일의 실행 가능한 뷰가 매핑됩니다(매핑된 메모리는 코드로 실행할 수 있음). 파일 매핑 개체는 PAGE_EXECUTE_READ, PAGE_EXECUTE_WRITECOPY 또는 PAGE_EXECUTE_READWRITE 보호를 사용하여 만들어졌어야 합니다.

Windows Server 2003 및 Windows XP: 이 값은 SP2가 있는 Windows XP 및 WINDOWS Server 2003 SP1부터 사용할 수 있습니다.

FILE_MAP_TARGETS_INVALID
매핑된 파일의 모든 위치를 CFG(Control Flow Guard)의 잘못된 대상으로 설정합니다. 이 플래그는 PAGE_TARGETS_INVALID 비슷합니다. 실행 액세스 권한 FILE_MAP_EXECUTE 함께 이 플래그를 사용합니다. 해당 페이지의 위치에 대한 간접 호출은 CFG 검사에 실패하고 프로세스가 종료됩니다. 할당된 실행 페이지에 대한 기본 동작은 CFG에 대한 유효한 호출 대상으로 표시되는 것입니다.
 

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

파일 매핑 개체에 대한 액세스에 대한 자세한 내용은 파일 매핑 보안 및 액세스 권한을 참조하세요.

[in] dwFileOffsetHigh

뷰가 시작될 파일 오프셋의 상위 DWORD 입니다.

[in] dwFileOffsetLow

뷰를 시작할 파일 오프셋의 하위 순서 DWORD 입니다. 높음 오프셋과 낮은 오프셋의 조합은 파일 매핑 내에서 오프셋을 지정해야 합니다. 또한 시스템의 메모리 할당 세분성과 일치해야 합니다. 즉, 오프셋은 할당 세분성의 배수여야 합니다. 시스템의 메모리 할당 세분성을 가져오려면 GetSystemInfo 함수를 사용하여 SYSTEM_INFO 구조체의 멤버를 채웁니다.

[in] dwNumberOfBytesToMap

뷰에 매핑할 파일 매핑의 바이트 수입니다. 모든 바이트는 CreateFileMapping에 지정된 최대 크기 내에 있어야 합니다. 이 매개 변수가 0이면 매핑이 지정된 오프셋에서 파일 매핑의 끝까지 확장됩니다.

[in, optional] lpBaseAddress

매핑이 시작되는 호출 프로세스 주소 공간의 메모리 주소에 대한 포인터입니다. 이는 시스템의 메모리 할당 세분성의 배수이거나 함수가 실패해야 합니다. 시스템의 메모리 할당 세분성을 확인하려면 GetSystemInfo 함수를 사용합니다. 지정된 주소에 주소 공간이 충분하지 않으면 함수가 실패합니다.

lpBaseAddressNULL인 경우 운영 체제는 매핑 주소를 선택합니다. 이 시나리오에서 함수는 MapViewOfFile 함수와 동일합니다.

지금은 안전한 주소(운영 체제에서 사용되지 않음)를 지정할 수 있지만 시간이 지남에 따라 주소가 안전하게 유지된다는 보장은 없습니다. 따라서 운영 체제에서 주소를 선택하도록 하는 것이 좋습니다. 이 경우 메모리 매핑된 파일에 포인터를 저장하지 않고, 매핑을 모든 주소에서 사용할 수 있도록 파일 매핑의 기본 오프셋을 저장합니다.

반환 값

함수가 성공하면 반환 값은 매핑된 뷰의 시작 주소입니다.

함수가 실패하면 반환 값은 NULL입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

파일을 매핑하면 호출 프로세스의 주소 공간에 파일의 지정된 부분이 표시됩니다.

주소 공간보다 큰 파일의 경우 파일 데이터의 작은 부분만 한 번에 매핑할 수 있습니다. 첫 번째 보기가 완료되면 매핑을 해제하고 새 보기를 매핑합니다.

뷰의 크기를 가져오려면 VirtualQueryEx 함수를 사용합니다.

페이지 파일에서 백업하는 파일 매핑 개체의 페이지 초기 콘텐츠는 0입니다.

일반적으로 제안된 주소는 여러 프로세스에서 동일한 주소에 파일을 매핑하도록 지정하는 데 사용됩니다. 이렇게 하려면 관련된 모든 프로세스에서 주소 공간 영역을 사용할 수 있어야 합니다. VirtualAlloc 또는 VirtualAllocEx 함수를 사용하여 메모리를 예약하는 등 매핑에 사용되는 지역에서 다른 메모리 할당을 수행할 수 없습니다.

lpBaseAddress 매개 변수가 기본 오프셋을 지정하면 지정된 메모리 영역이 호출 프로세스에서 아직 사용되지 않는 경우 함수가 성공합니다. 시스템은 다른 32비트 프로세스의 메모리 매핑 파일에 동일한 메모리 영역을 사용할 수 있는지 확인하지 않습니다.

지정된 시간에 동일한 데이터를 포함하는 경우 파일(또는 파일 매핑 개체 및 해당 매핑된 파일)의 여러 보기가 일관 됩니다. 이 문제는 파일 뷰가 동일한 파일 매핑 개체에서 파생되는 경우에 발생합니다. 프로세스는 DuplicateHandle 함수를 사용하여 파일 매핑 개체 핸들을 다른 프로세스로 복제하거나 다른 프로세스에서 OpenFileMapping 함수를 사용하여 이름으로 파일 매핑 개체를 열 수 있습니다.

한 가지 중요한 예외를 제외하고 동일한 파일에서 백업되는 파일 매핑 개체에서 파생된 파일 뷰는 특정 시간에 일관되거나 동일합니다. 일관성은 프로세스 내의 뷰 및 다른 프로세스에 의해 매핑되는 뷰에 대해 보장됩니다.

예외는 원격 파일과 관련이 있습니다. MapViewOfFileEx는 원격 파일에서 작동하지만 일관성을 유지하지는 않습니다. 예를 들어 두 컴퓨터가 모두 파일을 쓰기 가능으로 매핑하고 둘 다 동일한 페이지를 변경하는 경우 각 컴퓨터는 페이지에 대한 자체 쓰기만 볼 수 있습니다. 디스크에서 데이터가 업데이트되면 병합되지 않습니다.

파일의 매핑된 보기는 ReadFile 또는 WriteFile 함수에서 액세스하는 파일과 일관성이 보장되지 않습니다.

EXCEPTION_IN_PAGE_ERROR 예외를 방지하려면 구조적 예외 처리를 사용하여 페이지 파일 이외의 파일의 메모리 매핑 보기에서 쓰거나 읽는 코드를 보호합니다. 자세한 내용은 파일 보기에서 읽기 및 쓰기를 참조하세요.

매핑된 보기를 통해 파일을 수정하는 경우 마지막 수정 타임스탬프가 자동으로 업데이트되지 않을 수 있습니다. 필요한 경우 호출자는 SetFileTime 을 사용하여 타임스탬프를 설정해야 합니다.

실행 가능한 권한이 있는 파일을 사용하려면 애플리케이션이 PAGE_EXECUTE_READWRITE 또는 PAGE_EXECUTE_READ 사용하여 CreateFileMapping을 호출한 다음, FILE_MAP_EXECUTEFILE_MAP_WRITE또는 | FILE_MAP_EXECUTE FILE_MAP_READ | 있는 MapViewOfFileEx를 호출해야합니다.

Windows Server 2012 이 함수는 다음 기술에서 지원됩니다.

기술 지원됨
SMB(서버 메시지 블록) 3.0 프로토콜 Yes
SMB 3.0 TFO(투명 장애 조치(failover)) Yes
SO(스케일 아웃 파일 공유)를 사용하는 SMB 3.0 Yes
CsvFS(클러스터 공유 볼륨 파일 시스템) Yes
ReFS(Resilient File System) Yes

요구 사항

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

참고 항목

CreateFileMapping

파일 뷰 만들기

DuplicateHandle

파일 매핑 함수

GetSystemInfo

MapViewOfFileExNuma

OpenFileMapping

ReadFile

SYSTEM_INFO

UnmapViewOfFile

VirtualAlloc

WriteFile