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;
	);

DmiGetFirstPoolBlock is used to get the first block of memory in a pool previously created by DmiCreatePool(3dmi).

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.

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.