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:

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