Zen API
 All Classes Files Functions Variables Typedefs Friends Macros Modules Pages
kStatus kMsgQueue_Reserve ( kMsgQueue  queue,
kSize  count 
)

Reserves memory for the specified number of items.

This method reserves internal memory for queue items, in order to reduce occurences of internal memory allocation as the size of the queue grows. It is unrelated to the queue capacity constraints specified with the kMsgQueue_SetMaxSize or kMsgQueue_SetMaxCount methods.

This method is thread-safe.

Parameters
queueQueue object.
countCount of items for which to reserve capacity.
Returns
Operation status.