WIN32_MEMORY_REGION_INFORMATION-Struktur (memoryapi.h)

Enthält Informationen zu einem Speicherbereich. Ein Speicherbereich ist eine einzelne Zuordnung, die mithilfe einer Speicherbelegungsfunktion wie VirtualAlloc oder MapViewOfFile erstellt wird.

Syntax

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;

Members

AllocationBase

Die Basisadresse der Zuordnung.

AllocationProtect

Der Seitenschutzwert, der beim Erstellen der Zuordnung angegeben wurde. Der Schutz einzelner Seiten innerhalb der Zuordnung kann sich von diesem Wert unterscheiden. Verwenden Sie die VirtualQuery-Funktion , um Schutzwerte einzelner Seiten abzufragen.

DUMMYUNIONNAME

DUMMYUNIONNAME.Flags

Stellt alle Speicherbereichsflags als einzelnen ULONG-Wert dar. Anwendungen sollten dieses Feld nicht verwenden. Testen Sie stattdessen die unten definierten einzelnen Bitfeldflags.

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.Private

Der Wert 1 gibt an, dass die Zuordnung für den Prozess privat ist.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.MappedDataFile

Der Wert 1 gibt an, dass die Zuordnung eine zugeordnete Ansicht einer Datendatei ist.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.MappedImage

Der Wert 1 gibt an, dass die Zuordnung eine zugeordnete Ansicht eines ausführbaren Images ist.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.MappedPageFile

Der Wert 1 gibt an, dass die Zuordnung eine zugeordnete Ansicht eines Auslagerungsabschnitts ist.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.MappedPhysical

Der Wert 1 gibt an, dass die Zuordnung eine Ansicht des Abschnitts \Device\PhysicalMemory ist.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.DirectMapped

Der Wert 1 gibt an, dass die Zuordnung eine zugeordnete Ansicht einer direkt zugeordneten Datei ist.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.Reserved

Reserviert.

RegionSize

Die Größe der Speicherbelegung.

CommitSize

Die commit-Gebühr, die der Zuordnung zugeordnet ist. Bei privaten Zuordnungen ist dies die kombinierte Größe von Seiten in der Region, die committet werden, im Gegensatz zu reservierten. Bei zugeordneten Ansichten ist dies die kombinierte Größe von Seiten, die über Kopierschutz verfügen oder aufgrund von Copy-On-Write privat wurden.

Hinweise

Die WIN32_MEMORY_REGION_INFORMATION-Struktur enthält Informationen zu einer einzelnen Speicherbelegung. Im Gegensatz dazu beschreibt die MEMORY_BASIC_INFORMATION Struktur, die von der VirtualQuery-Funktion zurückgegeben wird, eine zusammenhängende Ausführung von Seiten innerhalb einer einzelnen Zuordnung, die alle denselben Typ, Zustand und Schutz aufweisen. Die Zuordnung zwischen WIN32_MEMORY_REGION_INFORMATION Feldern und Speichertypwerten, die von VirtualQuery zurückgegeben werden, sieht wie folgt aus:

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

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 10, Version 1607 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2016 [nur Desktop-Apps]
Kopfzeile memoryapi.h (windows.h einschließen)

Weitere Informationen

MEMORY_BASIC_INFORMATION

MapViewOfFile

VirtualAlloc

Virtualquery