Compartir a través de

Función RtlCreateHeap (ntifs.h)

  • Artículo

La rutina RtlCreateHeap crea un objeto de montón que el proceso de llamada puede usar. Esta rutina reserva espacio en el espacio de direcciones virtuales del proceso y asigna almacenamiento físico para una parte inicial especificada de este bloque.

Sintaxis

NTSYSAPI PVOID RtlCreateHeap(
  [in]           ULONG                Flags,
  [in, optional] PVOID                HeapBase,
  [in, optional] SIZE_T               ReserveSize,
  [in, optional] SIZE_T               CommitSize,
  [in, optional] PVOID                Lock,
  [in, optional] PRTL_HEAP_PARAMETERS Parameters
);

Parámetros

[in] Flags

Marcas que especifican atributos opcionales del montón. Estas opciones afectan al acceso posterior al nuevo montón a través de llamadas a las funciones del montón (RtlAllocateHeap y RtlFreeHeap).

Los autores de llamadas deben establecer este parámetro en cero si no se solicitan atributos opcionales.

Este parámetro puede ser uno o más de los siguientes valores.

Valor Significado
HEAP_GENERATE_EXCEPTIONS Especifica que el sistema indicará un error de montón generando una excepción, como STATUS_NO_MEMORY, en lugar de devolver NULL.
HEAP_GROWABLE Especifica que el montón se puede crecer. Debe especificarse si HeapBase es NULL.
HEAP_NO_SERIALIZE Especifica que la exclusión mutua no se usará cuando las funciones del montón asignen y liberen memoria de este montón. El valor predeterminado, cuando no se especifica HEAP_NO_SERIALIZE, es serializar el acceso al montón. La serialización del acceso al montón permite que dos o más subprocesos asignen y liberen memoria simultáneamente del mismo montón.

[in, optional] HeapBase

Especifica una de estas dos acciones:

Si HeapBase es un valor distinto de NULL, especifica la dirección base de un bloque de memoria asignada por el autor de la llamada que se va a usar para el montón.

Si HeapBase es NULL, RtlCreateHeap asigna memoria del sistema para el montón desde el espacio de direcciones virtuales del proceso.

[in, optional] ReserveSize

Si ReserveSize es un valor distinto de cero, especifica la cantidad inicial de memoria, en bytes, que se va a reservar para el montón. RtlCreateHeap redondea ReserveSize hasta el límite de la página siguiente y, a continuación, reserva un bloque de ese tamaño para el montón.

Este parámetro es opcional y puede ser cero. En la tabla siguiente se resume la interacción de los parámetros ReserveSize y CommitSize .

Valores Resultado
ReserveSize cero, CommitSize cero Inicialmente se reservan 64 páginas para el montón. Se confirma inicialmente una página.
ReserveSize cero, CommitSize nonzero RtlCreateHeap establece ReserveSize para que sea igual a CommitSize y, a continuación, redondea ReserveSize hasta el múltiplo más cercano de (PAGE_SIZE * 16).
ReserveSize nonzero, CommitSize cero Una página se confirma inicialmente para el montón.
ReserveSize nonzero, CommitSize nonzero Si CommitSize es mayor que ReserveSize, RtlCreateHeap reduce CommitSize a ReserveSize.

[in, optional] CommitSize

Si CommitSize es un valor distinto de cero, especifica la cantidad inicial de memoria, en bytes, para confirmar el montón. RtlCreateHeap redondea CommitSize hasta el límite de la página siguiente y, a continuación, confirma un bloque de ese tamaño en el espacio de direcciones virtuales del proceso para el montón.

Este parámetro es opcional y puede ser cero.

[in, optional] Lock

Puntero a una estructura ERESOURCE opaca que se va a usar como bloqueo de recursos. Este parámetro es opcional y puede ser NULL. Cuando lo proporciona el autor de la llamada, la estructura debe asignarse desde un grupo no paginado e inicializarse llamando a ExInitializeResourceLite o ExReinitializeResourceLite. Si se establece la marca HEAP_NO_SERIALIZE, este parámetro debe ser NULL.

[in, optional] Parameters

Puntero a una estructura de RTL_HEAP_PARAMETERS que contiene parámetros que se van a aplicar al crear el montón. Este parámetro es opcional y puede ser NULL.

Valor devuelto

RtlCreateHeap devuelve un identificador que se usará para acceder al montón creado.

Comentarios

RtlCreateHeap crea un objeto de montón privado desde el que el proceso de llamada puede asignar bloques de memoria llamando a RtlAllocateHeap. El tamaño de confirmación inicial determina el número de páginas asignadas inicialmente para el montón. El tamaño de reserva inicial determina el número de páginas reservadas inicialmente para el montón. Las páginas reservadas pero sin confirmar crean un bloque en el espacio de direcciones virtuales del proceso en el que el montón se puede expandir.

Si las solicitudes de asignación realizadas por RtlAllocateHeap superan el tamaño de confirmación inicial del montón, el sistema confirma páginas adicionales de almacenamiento físico para el montón, hasta el tamaño máximo del montón. Si el montón no se puede crecer, su tamaño máximo se limita a su tamaño de reserva inicial.

Si el montón se puede crecer, su tamaño solo está limitado por la memoria disponible. Si las solicitudes de RtlAllocateHeap superan el tamaño actual de las páginas confirmadas, el sistema llama a ZwAllocateVirtualMemory para obtener la memoria necesaria, suponiendo que el almacenamiento físico está disponible.

Además, si el montón no se puede crecer, surge una limitación absoluta: el tamaño máximo de un bloque de memoria del montón es 0x7F000 bytes. El umbral de memoria virtual del montón es igual al tamaño máximo del bloque de montón o al valor del miembro VirtualMemoryThreshold de la estructura Parameters , lo que sea menor. El montón también puede necesitar rellenar el tamaño de la solicitud con fines de alineación y metadatos, por lo que las solicitudes para asignar bloques dentro de 4096 Bytes (1 página) de VirtualMemoryThreshold pueden producir un error incluso si el tamaño máximo del montón es lo suficientemente grande como para contener el bloque. (Para obtener más información sobre VirtualMemoryThreshold, vea los miembros del parámetro Parameters a RtlCreateHeap).

Si el montón es cada vez mayor, las solicitudes para asignar bloques mayores que el umbral de memoria virtual del montón no fallan automáticamente; el sistema llama a ZwAllocateVirtualMemory para obtener la memoria necesaria para estos bloques grandes.

La memoria de un objeto de montón privado solo es accesible para el proceso que lo creó.

El sistema usa memoria del montón privado para almacenar estructuras compatibles con el montón, por lo que no todo el tamaño del montón especificado está disponible para el proceso. Por ejemplo, si RtlAllocateHeap solicita 64 kilobytes (K) desde un montón con un tamaño máximo de 64 K, la solicitud puede producir un error debido a la sobrecarga del sistema.

Si no se especifica HEAP_NO_SERIALIZE (el valor predeterminado simple), el montón serializará el acceso dentro del proceso de llamada. 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 se debe usar cada vez que varios subprocesos asignan y liberan memoria del mismo montón.

Establecer 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, 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 en un montón específico.

Nota

Para protegerse contra una infracción de acceso, use el control de excepciones estructurados para proteger cualquier código que escriba en un montón o lea desde él. Para obtener más información sobre el control estructurado de excepciones con accesos a memoria, vea Control de excepciones**.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP
Plataforma de destino Universal
Encabezado ntifs.h (incluya Ntifs.h)
Library Ntoskrnl.lib
Archivo DLL NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuario)
IRQL < DISPATCH_LEVEL

Consulte también

RtlAllocateHeap

RtlDestroyHeap

RtlFreeHeap