Fungsi MapViewOfFile2 (memoryapi.h)
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 |