Bagikan melalui

Fungsi MapViewOfFileNuma2 (memoryapi.h)

  • Artikel

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

Sintaks

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

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.

[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

[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.

[in] PreferredNode

Simpul NUMA pilihan untuk memori ini.

Nilai kembali

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

Persyaratan

Persyaratan Nilai
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; Onecoreuap.lib
DLL Api-ms-win-core-memory-l1-1-5.dll

Lihat juga

MapViewOfFile

MapViewOfFileNuma