Zen API
 All Classes Files Functions Variables Typedefs Friends Macros Modules Pages
kStatus kPoolAlloc_ReserveAt ( kPoolAlloc  object,
kSize  rank,
kSize  size 
)

Specifies the minimum amount of memory that should be set aside at a particular rank.

This function can be used to ensure that the specified amount of memory is set aside for block-based allocations at a specific rank.

This function can also be used to pre-cache individual buffers at a specific rank. However, these buffers may later be deallocated if the CacheCapacity limit is reached.

This function cannot be used before calling kPoolAlloc_Start.

Parameters
objectkPoolAlloc object.
rankMemory rank (base-2 logarithm of memory size).
sizeAmount of memory to reserve, in bytes.
Returns
Operation status.