DmiCreatePoolMemDsc(3dmi)


DmiCreatePoolMemDsc -- create a pool descriptor

Synopsis

#include <dmi2mem.h>

DmiMemDsc_t DMI_API DmiCreatePoolMemDsc( DmiAllocFail_t * allocFail, DmiErrorStatus_t * status );

Description

DmiCreatePoolMemDsc is used to create a pool descriptor. Subsequent calls to DmiAlloc(3dmi) should use a pool descriptor to associate allocated memory with that pool. Similarly, the DmiFree(3dmi) function in this memory model will release memory blocks belonging to the pool.

Parameters


allocFail
(Input)

status
(Output)

Return values

When successful, the function returns the memory model descriptor. Otherwise, it returns NULL. If the status pointer is not NULL, then the referenced value will contain the DMI error code on return. Otherwise, an error status is not returned.


NOTE: Multiple active pools can exist simultaneously.

Notices

Portions of this page are derived from material for which the copyright owner is Intel Corporation, Inc. The material is reprinted with permission. See copyright page for a full statement of rights and permissions.


© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004