DmiGetFirstPoolBlock(3dmi)
DmiGetFirstPoolBlock --
get the first block of memory in a pool
Synopsis
#include <dmi2mem.h>
void * DMI_API DmiGetFirstPoolBlock (
void * pool_handle;
DmiErrorstatus * status;
);
Description
DmiGetFirstPoolBlock is used to get the first block
of memory in a pool previously created by
DmiCreatePool(3dmi).
Parameters
pool_handle-
The start address of the memory pool that was returned
by a call to DmiCreatePool.
status-
Pointer to an address in memory where the DmiErrorStatus_t
code is returned or NULL. If the status pointer
is NULL, the error status is not returned.
Return values
This function returns the pointer to the allocated block
or NULL in case of failure.
Status returned to status are:
-
DMIERR_NO_ERROR
-
DMIERR_MEM_NO_BLOCK_IN_POOL
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