RtlCreateHeap - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
#ifndef _NTRTL_H

_Must_inspect_result_
NTSYSAPI
PVOID
NTAPI
RtlCreateHeap(
    _In_ ULONG Flags,
    _In_opt_ PVOID HeapBase,
    _In_opt_ SIZE_T ReserveSize,
    _In_opt_ SIZE_T CommitSize,
    _In_opt_ PVOID Lock,
    _When_((Flags & HEAP_CREATE_SEGMENT_HEAP) != 0, _In_reads_bytes_opt_(sizeof(RTL_SEGMENT_HEAP_PARAMETERS)))
    _When_((Flags & HEAP_CREATE_SEGMENT_HEAP) == 0, _In_reads_bytes_opt_(sizeof(RTL_HEAP_PARAMETERS)))
    _In_opt_ PVOID Parameters
    );

#endif

View code on GitHub

This function is documented in Windows Driver Kit.


Flags

Flags are defined in <WinNT.h>. Can be one of following:

Base

Base address, where heap should be created. If memory was previously allocated at this address, heap is created at the nearest possible virtual address.

Reserve

How much bytes should be reserved. See NtAllocateVirtualMemory.

Commit

How many bytes should be committed. If Reserve is greater than zero, Commit must be less or equal to Reserve.

Lock

If set, heap will be locked. See RtlLockHeap / RtlUnlockHeap.

RtlHeapParams

Pointer to RTL_HEAP_DEFINITION structure. On NT 4.0 all bytes of this (except length field) are set to zero.

Documented by

See also