PROCESS_HEAP_ENTRY struttura (minwinbase.h)

Contiene informazioni su un elemento heap. La funzione HeapWalk usa una struttura PROCESS_HEAP_ENTRY per enumerare gli elementi di un heap.

Sintassi

typedef struct _PROCESS_HEAP_ENTRY {
  PVOID lpData;
  DWORD cbData;
  BYTE  cbOverhead;
  BYTE  iRegionIndex;
  WORD  wFlags;
  union {
    struct {
      HANDLE hMem;
      DWORD  dwReserved[3];
    } Block;
    struct {
      DWORD  dwCommittedSize;
      DWORD  dwUnCommittedSize;
      LPVOID lpFirstBlock;
      LPVOID lpLastBlock;
    } Region;
  } DUMMYUNIONNAME;
} PROCESS_HEAP_ENTRY, *LPPROCESS_HEAP_ENTRY, *PPROCESS_HEAP_ENTRY;

Members

lpData

Puntatore alla parte dati dell'elemento heap.

Per avviare un'enumerazione heap HeapWalk , impostare lpData su NULL.

Se PROCESS_HEAP_REGION viene usato nel membro wFlags , lpData punta al primo indirizzo virtuale usato dall'area.

Se PROCESS_HEAP_UNCOMMITTED_RANGE viene usato in wFlags, lpData punta all'inizio dell'intervallo di memoria non commessa.

cbData

Dimensioni della parte dati dell'elemento heap, in byte.

Se PROCESS_HEAP_REGION viene usato in wFlags, cbData specifica le dimensioni totali, in byte, dello spazio indirizzi riservato per questa area.

Se PROCESS_HEAP_UNCOMMITTED_RANGE viene usato in wFlags, cbData specifica le dimensioni, in byte, dell'intervallo di memoria non commessa.

cbOverhead

Dimensioni dei dati usati dal sistema per mantenere le informazioni sull'elemento heap, in byte. Questi byte di sovraccarico si aggiungono ai byte cbData della parte dati dell'elemento heap.

Se PROCESS_HEAP_REGION viene usato in wFlags, cbOverhead specifica le dimensioni, in byte, delle strutture di controllo heap che descrivono l'area.

Se PROCESS_HEAP_UNCOMMITTED_RANGE viene usato in wFlags, cbOverhead specifica le dimensioni, in byte, delle strutture di controllo che descrivono l'intervallo non generato.

iRegionIndex

Handle per l'area dell'heap contenente l'elemento heap. Un heap è costituito da una o più aree di memoria virtuale, ognuna con un indice di area univoco.

Nella prima voce heap restituita per la maggior parte delle aree heap, HeapWalk usa il PROCESS_HEAP_REGION nel membro wFlags . Quando viene usato questo valore, i membri della struttura Region contengono informazioni aggiuntive sull'area.

La funzione HeapAlloc a volte usa la funzione VirtualAlloc per allocare blocchi di grandi dimensioni da un heap scalabile. Il gestore heap considera un'allocazione a blocchi di grandi dimensioni come un'area separata con un indice di area univoco. HeapWalk non usa PROCESS_HEAP_REGION nella voce heap restituita per un'area di blocchi di grandi dimensioni, pertanto i membri della struttura Region non sono validi. È possibile usare la funzione VirtualQuery per ottenere informazioni aggiuntive su un'area di blocchi di grandi dimensioni.

wFlags

Proprietà dell'elemento heap. Alcuni valori influiscono sul significato di altri membri di questa struttura di dati PROCESS_HEAP_ENTRY . I valori seguenti sono definiti.

DUMMYUNIONNAME

DUMMYUNIONNAME.Block

Questa struttura è valida solo se i PROCESS_HEAP_ENTRY_BUSY e i PROCESS_HEAP_ENTRY_MOVEABLE vengono specificati in wFlags.

DUMMYUNIONNAME.Block.hMem

Gestire il blocco di memoria allocato e spostato.

DUMMYUNIONNAME.Block.dwReserved[3]

Riservati; non usato.

DUMMYUNIONNAME.Region

Questa struttura è valida solo se il membro wFlags specifica PROCESS_HEAP_REGION.

DUMMYUNIONNAME.Region.dwCommittedSize

Numero di byte nell'area heap attualmente commit come blocchi di memoria gratuiti, blocchi di memoria occupati o strutture di controllo heap.

Si tratta di un campo facoltativo impostato su zero se il numero di byte di commit non è disponibile.

DUMMYUNIONNAME.Region.dwUnCommittedSize

Numero di byte nell'area heap attualmente non commessa.

Si tratta di un campo facoltativo impostato su zero se il numero di byte non inviati non è disponibile.

DUMMYUNIONNAME.Region.lpFirstBlock

Puntatore al primo blocco di memoria valido in questa area heap.

DUMMYUNIONNAME.Region.lpLastBlock

Puntatore al primo blocco di memoria non valido in questa area heap.

Requisiti

Vedi anche

Globalalloc

HeapAlloc

HeapWalk

Virtualalloc

VirtualQuery