Función HeapAlloc (heapapi.h)

Asigna un bloque de memoria de un montón. La memoria asignada no se puede mover.

Sintaxis

DECLSPEC_ALLOCATOR LPVOID HeapAlloc(
  [in] HANDLE hHeap,
  [in] DWORD  dwFlags,
  [in] SIZE_T dwBytes
);

Parámetros

[in] hHeap

Identificador del montón desde el que se asignará la memoria. La función HeapCreate o GetProcessHeap devuelve este identificador.

[in] dwFlags

Opciones de asignación del montón. Al especificar cualquiera de estos valores, se invalidará el valor correspondiente especificado cuando se creó el montón con HeapCreate. Este parámetro puede ser uno o más de los siguientes valores.

[in] dwBytes

Número de bytes que se van a asignar.

Si el montón especificado por el parámetro hHeap es un montón "no cultivable", dwBytes debe ser menor que 0x7FFF8. Para crear un montón no cultivable, llame a la función HeapCreate con un valor distinto de cero.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un puntero al bloque de memoria asignado.

Si se produce un error en la función y no se ha especificado HEAP_GENERATE_EXCEPTIONS, el valor devuelto es NULL.

Si se produce un error en la función y ha especificado HEAP_GENERATE_EXCEPTIONS, la función puede generar cualquiera de las excepciones enumeradas en la tabla siguiente. La excepción determinada depende de la naturaleza de los daños en el montón. Para obtener más información, vea GetExceptionCode.

Si se produce un error en la función, no llama a SetLastError. Una aplicación no puede llamar a GetLastError para obtener información de error extendida.

Comentarios

Si la función HeapAlloc se realiza correctamente, asigna al menos la cantidad de memoria solicitada.

Para asignar memoria del montón predeterminado del proceso, use HeapAlloc con el identificador devuelto por la función GetProcessHeap .

Para liberar un bloque de memoria asignado por HeapAlloc, use la función HeapFree .

La memoria asignada por HeapAlloc no se puede mover. La dirección devuelta por HeapAlloc es válida hasta que el bloque de memoria se libera o se reasigna; no es necesario bloquear el bloque de memoria. Dado que el sistema no puede compactar un montón privado, se puede fragmentar.

La alineación de la memoria devuelta por HeapAlloc se MEMORY_ALLOCATION_ALIGNMENT en WinNT.h:

#if defined(_WIN64) || defined(_M_ALPHA)
#define MEMORY_ALLOCATION_ALIGNMENT 16
#else
#define MEMORY_ALLOCATION_ALIGNMENT 8
#endif

Las aplicaciones que asignan grandes cantidades de memoria en varios tamaños de asignación pueden usar el montón de baja fragmentación para reducir la fragmentación del montón.

La serialización garantiza la exclusión mutua cuando dos o más subprocesos intentan asignar o liberar bloques simultáneamente del mismo montón. Hay un pequeño costo de rendimiento para la serialización, pero debe usarse siempre que varios subprocesos asignen y liberen memoria del mismo montón. Establecer el valor de HEAP_NO_SERIALIZE elimina la exclusión mutua en el montón. Sin serialización, dos o más subprocesos que usan el mismo identificador de montón podrían intentar asignar o liberar memoria simultáneamente, lo que probablemente causaría daños en el montón. Por lo tanto, el valor de HEAP_NO_SERIALIZE solo se puede usar de forma segura en las situaciones siguientes:

• El proceso solo tiene un subproceso.
• El proceso tiene varios subprocesos, pero solo un subproceso llama a las funciones del montón para un montón específico.
• El proceso tiene varios subprocesos y la aplicación proporciona su propio mecanismo para la exclusión mutua a un montón específico.

Ejemplos

Para obtener un ejemplo, vea Ejemplo de AWE.

Requisitos

Vea también

Funciones del montón

HeapFree

HeapReAlloc

Funciones de administración de memoria

API de Vertdll disponibles en enclaves de VBS