DmiGetNextPoolBlock(3dmi)

DmiGetNextPoolBlock -- get the next block in a pool of memory

Synopsis

#include <dmi2mem.h>

DmiVoid_t * DMI_API DmiGetNextPoolBlock (
	void * ptr;
	void * pool_handle;
	void * status;
	);

DmiGetNextPoolBlock is used to get the next block in a pool of memory.

ptr: A pointer to a memory block in the pool. DmiGetFirstPoolBlock(3dmi).
pool_handle: The pool_handle returned by a call to DmiCreatePool(3dmi).
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 next block or NULL in case of failure.

Status codes returned to status are:

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