struktur WIN32_MEMORY_REGION_INFORMATION (memoryapi.h)

  • Artikel

Berisi informasi tentang wilayah memori. Wilayah memori adalah alokasi tunggal yang dibuat menggunakan fungsi alokasi memori, seperti VirtualAlloc atau MapViewOfFile.

Sintaks

typedef struct WIN32_MEMORY_REGION_INFORMATION {
  PVOID  AllocationBase;
  ULONG  AllocationProtect;
  union {
    ULONG Flags;
    struct {
      ULONG Private : 1;
      ULONG MappedDataFile : 1;
      ULONG MappedImage : 1;
      ULONG MappedPageFile : 1;
      ULONG MappedPhysical : 1;
      ULONG DirectMapped : 1;
      ULONG Reserved : 26;
    } DUMMYSTRUCTNAME;
  } DUMMYUNIONNAME;
  SIZE_T RegionSize;
  SIZE_T CommitSize;
} WIN32_MEMORY_REGION_INFORMATION;

Anggota

AllocationBase

Alamat dasar alokasi.

AllocationProtect

Nilai perlindungan halaman yang ditentukan saat alokasi dibuat. Perlindungan halaman individual dalam alokasi dapat berbeda dari nilai ini. Untuk mengkueri nilai perlindungan halaman individual, gunakan fungsi VirtualQuery .

DUMMYUNIONNAME

DUMMYUNIONNAME.Flags

Mewakili semua bendera wilayah memori sebagai nilai ULONG tunggal. Aplikasi tidak boleh menggunakan bidang ini. Sebagai gantinya, uji bendera bidang bit individual yang ditentukan di bawah ini.

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.Private

Nilai 1 menunjukkan bahwa alokasi bersifat privat untuk proses.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.MappedDataFile

Nilai 1 menunjukkan bahwa alokasi adalah tampilan file data yang dipetakan.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.MappedImage

Nilai 1 menunjukkan bahwa alokasi adalah tampilan yang dipetakan dari gambar yang dapat dieksekusi.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.MappedPageFile

Nilai 1 menunjukkan bahwa alokasi adalah tampilan yang dipetakan dari bagian yang didukung pagefile.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.MappedPhysical

Nilai 1 menunjukkan bahwa alokasi adalah tampilan dari bagian \Device\PhysicalMemory .

DUMMYUNIONNAME.DUMMYSTRUCTNAME.DirectMapped

Nilai 1 menunjukkan bahwa alokasi adalah tampilan yang dipetakan dari file yang dipetakan langsung.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.Reserved

Dicadangkan.

RegionSize

Ukuran alokasi.

CommitSize

Biaya penerapan yang terkait dengan alokasi. Untuk alokasi privat, ini adalah ukuran gabungan halaman di wilayah yang diterapkan, dibandingkan dengan yang dicadangkan. Untuk tampilan yang dipetakan, ini adalah ukuran gabungan halaman yang memiliki perlindungan copy-on-write, atau telah dibuat privat sebagai hasil dari copy-on-write.

Keterangan

Struktur WIN32_MEMORY_REGION_INFORMATION berisi informasi tentang alokasi memori tunggal. Sebaliknya, struktur MEMORY_BASIC_INFORMATION yang dikembalikan oleh fungsi VirtualQuery menjelaskan eksekusi halaman yang berdekatan dalam satu alokasi yang semuanya memiliki jenis, status, dan perlindungan yang sama. Pemetaan antara bidang WIN32_MEMORY_REGION_INFORMATION dan nilai jenis memori yang dikembalikan oleh VirtualQuery adalah sebagai berikut:

WIN32_MEMORY_REGION_INFORMATION MEMORY_BASIC_INFORMATION::Type
Privat MEM_PRIVATE
MappedDataFile MEM_MAPPED
MappedImage MEM_IMAGE
MappedPageFile MEM_MAPPED
MappedPhysical MEM_MAPPED

Persyaratan

   
Klien minimum yang didukung Windows 10, versi 1607 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2016 [hanya aplikasi desktop]
Header memoryapi.h (termasuk Windows.h)

Lihat juga

MEMORY_BASIC_INFORMATION

MapViewOfFile

VirtualAlloc

VirtualQuery