DmiPoolAlloc(3dmi)

DmiPoolAlloc -- allocate a memory block in a pool

Synopsis

#include <dmi2mem.h>

Void * DMI_API DmiPoolAlloc (
	size_t size;
	void * pool_handle;
	Dmi_ErrorStatus_t * status;
	);

Description

DmiPoolAlloc is used to allocate size-byte memory in a pool of memory previously created by DmiCreatePool(3dmi). When successful, it returns a pointer to the allocated block, otherwise it returns NULL.

Parameters

size: (input) Memory block size
pool_handle: Pool handle created by DmiCreatePool(3dmi).
status: Pointer to an address in memory where the DmiErrorStatus_t code is returned or NULL.

Return values

This function returns the pointer to the allocated block or NULL in case of failure.

The status returned is one of:

DMIERR_NO_ERROR
DMIERR_OUT_OF_MEMORY

For a description of return values, see ``DMI error codes'' in Desktop Management Interface programming.