DmiAlloc(3dmi)


DmiAlloc -- allocate a memory block

Synopsis

#include <dmi2mem.h>

void * DMI_API DmiAlloc ( size_t size, DmiMemDsc_t memDsc, DmiErrorStatus_t * status);

Description

DmiAlloc allocates a size-byte memory block in the memory model specified by memDsc. When successful, it returns a pointer to the allocated block. Otherwise, it returns NULL and calls the failure handler defined in memDsc.

Parameters


size
(Input) Memory block size in octets.

memDsc
(Input) Memory model descriptor. If memDsc is NULL, the default memory model is used.

status
(Output) Pointer to an address in memory where the DmiErrorStatus_t code is returned or NULL. If the status pointer is NULL then the error status is not returned.

Return values

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

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