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.
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004