DmiCreateMemDsc(3dmi)

DmiCreateMemDsc -- create and initialize a memory management descriptor

Synopsis

#include <dmi2mem.h>

DmiMemDsc_t DMI_API DmiCreateMemDsc (
	DmiNodeAlloc_t* nodeAlloc,
	DmiNodeFree_t * nodeFree,
	DmiAllocFail_t * allocFail,
	void * mgmtData ,
	DmiErrorStatus_t * status
);

Description

DmiCreateMemDsc creates a memory management descriptor and fills it in with the specified parameters.

Parameters

nodeAlloc

(Input) Memory allocation function.

nodeFree

(Input) Memory deallocation function.

allocFail

(Input) Memory allocation failure handler.

mgmtData

(Input) Pointer to the memory model private data.

status

(Output) NULL, or a pointer to an address in memory where the DmiErrorStatus_t code is returned. If the status pointer is NULL then the error status is not returned. The possible error codes are:

DMIERR_NO_ERROR
DMIERR_OUT_OF_MEMORY
DMIERR_MEM_INIT_FAILURE

For a description of return values, see ``DMI error codes'' in Desktop Management Interface programming.

Return values

When successful, this function returns the memory model descriptor. Otherwise, it returns NULL.

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.