Fungsi MapViewOfFile2 (memoryapi.h)

  • Artikel

Memetakan tampilan file atau bagian yang didukung pagefile ke ruang alamat proses yang ditentukan.

Sintaks

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
);

Parameter

[in] FileMappingHandle

HANDLE ke bagian yang akan dipetakan ke ruang alamat proses yang ditentukan.

[in] ProcessHandle

HANDLE ke proses di mana bagian akan dipetakan. Handel harus memiliki masker akses PROCESS_VM_OPERATION .

[in] Offset

Offset dari awal bagian. Ini harus selaras 64k.

[in, optional] BaseAddress

Alamat dasar tampilan yang diinginkan. Alamat dibulatkan ke bawah ke batas 64k terdekat. Jika parameter ini NULL, sistem akan memilih alamat dasar.

[in] ViewSize

Jumlah byte yang akan dipetakan. Nilai nol (0) menentukan bahwa seluruh bagian akan dipetakan.

[in] AllocationType

Jenis alokasi. Parameter ini bisa nol (0) atau salah satu nilai konstanta berikut:

  • MEM_RESERVE - Memetakan tampilan yang dipesan.
  • MEM_LARGE_PAGES - Memetakan tampilan halaman besar. Bendera ini menentukan bahwa tampilan harus dipetakan menggunakan dukungan halaman besar. Ukuran tampilan harus kelipatan ukuran halaman besar yang dilaporkan oleh fungsi GetLargePageMinimum , dan objek pemetaan file harus dibuat menggunakan opsi SEC_LARGE_PAGES . Jika Anda memberikan nilai non-null untuk parameter BaseAddress , maka nilainya harus kelipatan GetLargePageMinimum.

[in] PageProtection

Perlindungan halaman yang diinginkan.

Untuk objek pemetaan file yang dibuat dengan atribut SEC_IMAGE , parameter PageProtection tidak berpengaruh, dan harus diatur ke nilai yang valid seperti PAGE_READONLY.

Menampilkan nilai

Mengembalikan alamat dasar tampilan yang dipetakan, jika berhasil. Jika tidak, mengembalikan NULL dan status kesalahan yang diperluas tersedia menggunakan GetLastError.

Keterangan

Fungsi ini diimplementasikan sebagai fungsi sebaris di header dan tidak dapat ditemukan di pustaka ekspor atau DLL apa pun. Ini sama dengan memanggil MapViewOfFileNuma2 dengan parameter terakhir yang diatur ke NUMA_NO_PREFERRED_NODE.

Persyaratan

   
Klien minimum yang didukung Windows 10, versi 1703 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2016 [hanya aplikasi desktop]
Target Platform Windows
Header memoryapi.h (termasuk Windows.h, Memoryapi.h)
Pustaka onecore.lib
DLL Kernel32.dll

Lihat juga

MapViewOfFile

MapViewOfFileNuma2