MEMFreeByStateToFrmHeap

Syntax

#include <cafe/mem.h>

BOOL MEMFreeByStateToFrmHeap( 
                        MEMHeapHandle    heap, 
                        u32              tagName );

Parameters

heap Frame heap handle.
tagName Tag attached to the status record.

Return Values

Returns TRUE if memory blocks were successfully deallocated using the status record. Returns FALSE if it fails.

Description

Deallocates memory allocated since the record state. If 0 is specified for tagName, the state recorded from the previous call to the MEMRecordStateForFrmHeap function is used. If a nonzero value is specified, the state record associated with the tag value is used. If multiple tags share the same value, the previously recorded state record is used.

If tagName is 0 and a status has never been recorded, the function fails. The function also fails if a state record with the specified tag value does not exist.

If the tag value is set and freed, state records that are saved after this record with the same tag value are deleted.

Do Not Call From

Callbacks Do not call this function from any callback function.

See Also

MEMRecordStateForFrmHeap

Revision History

2013/05/08 Automated cleanup pass.
2010/11/01 Initial version.


CONFIDENTIAL