Share via


MapViewOfFileNuma2 함수(memoryapi.h)

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

구문

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

매개 변수

[in] FileMappingHandle

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

[in] ProcessHandle

섹션을 매핑할 프로세스에 대한 핸들 입니다.

[in] Offset

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

[in, optional] BaseAddress

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

[in] ViewSize

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

[in] AllocationType

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

  • MEM_RESERVE - 예약된 보기 매핑
  • MEM_LARGE_PAGES - 큰 페이지 보기 매핑

[in] PageProtection

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

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

[in] PreferredNode

이 메모리에 대한 기본 NUMA 노드입니다.

반환 값

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

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 10, 버전 1703 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 memoryapi.h(Windows.h, Memoryapi.h 포함)
라이브러리 Onecore.lib; Onecoreuap.lib
DLL Api-ms-win-core-memory-l1-1-5.dll

추가 정보

MapViewOfFile

MapViewOfFileNuma