WIN32_MEMORY_REGION_INFORMATION struttura (memoryapi.h)

Contiene informazioni su un'area di memoria. Un'area di memoria è una singola allocazione creata usando una funzione di allocazione della memoria, ad esempio VirtualAlloc o MapViewOfFile.

Sintassi

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

Indirizzo di base dell'allocazione.

AllocationProtect

Valore di protezione della pagina specificato al momento della creazione dell'allocazione. Le protezioni delle singole pagine all'interno dell'allocazione possono essere diverse da questo valore. Per eseguire query sui valori di protezione delle singole pagine, usare la funzione VirtualQuery .

DUMMYUNIONNAME

DUMMYUNIONNAME.Flags

Rappresenta tutti i flag di area di memoria come singolo valore ULONG. Le applicazioni non devono usare questo campo. Testare invece i singoli flag di campo di bit definiti di seguito.

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.Private

Un valore pari a 1 indica che l'allocazione è privata al processo.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.MappedDataFile

Un valore 1 indica che l'allocazione è una visualizzazione mappata di un file di dati.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.MappedImage

Il valore 1 indica che l'allocazione è una visualizzazione mappata di un'immagine eseguibile.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.MappedPageFile

Un valore 1 indica che l'allocazione è una visualizzazione mappata di una sezione supportata da pagefile.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.MappedPhysical

Un valore pari a 1 indica che l'allocazione è una visualizzazione della sezione \Device\PhysicalMemory .

DUMMYUNIONNAME.DUMMYSTRUCTNAME.DirectMapped

Un valore 1 indica che l'allocazione è una visualizzazione mappata di un file mappato diretto.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.Reserved

Riservato.

RegionSize

Dimensione dell'allocazione.

CommitSize

Addebito di commit associato all'allocazione. Per le allocazioni private, questa è la dimensione combinata delle pagine nell'area con commit, anziché riservata. Per le visualizzazioni mappate, questa è la dimensione combinata di pagine che dispongono di protezione da copia in scrittura o sono state rese private come risultato della copia in scrittura.

Commenti

La struttura WIN32_MEMORY_REGION_INFORMATION contiene informazioni su una singola allocazione di memoria. Al contrario, la struttura MEMORY_BASIC_INFORMATION restituita dalla funzione VirtualQuery descrive un'esecuzione contigua di pagine all'interno di una singola allocazione con lo stesso tipo, stato e protezione. Il mapping tra i campi WIN32_MEMORY_REGION_INFORMATION e i valori dei tipi di memoria restituiti da VirtualQuery è il seguente:

WIN32_MEMORY_REGION_INFORMATION	MEMORY_BASIC_INFORMATION::Type
Privato	MEM_PRIVATE
MappedDataFile	MEM_MAPPED
MappedImage	MEM_IMAGE
MappedPageFile	MEM_MAPPED
MappadPhysical	MEM_MAPPED

Requisiti

Client minimo supportato	Windows 10 versione 1607 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Intestazione	memoryapi.h (include Windows.h)

Vedi anche

MEMORY_BASIC_INFORMATION

MapViewOfFile

Virtualalloc

VirtualQuery