PurifyPostFree

Custom Memory Allocation Example

Related Topics

Description

Provides Purify with information about a completed memory deallocation. Call this function right after invoking custom memory block deallocation code.

Syntax

void PurifyPostFree(unsigned int dwFlags)

 

dwFlags

May include any of the following flags, or 0 to indicate none of them

 

Flag 

Meaning 

PURIFY_TRACK_AS_HEAP

The block was allocated within a Windows heap

Returns

void  

Notes

§      This function supplies Purify with information about a completed memory block deallocation. Use this function in conjunction with the PurifyPreFree() function, which indicates to Purify when a deallocation is pending.

§      Purify cannot detect free-memory reads or writes involving blocks that have been deallocated by custom deallocation functions. Purify also cannot detect multiple attempts to free such blocks.

§      This function is a member of Purify's memory tracking interface. The example code provided for Purify's memory tracking interface demonstrates this function.

§      This function is necessary only for custom memory deallocation routines. Purify automatically intercepts standard Windows and C runtime deallocation API functions.

(C) Copyright IBM Corporation 1992, 2010.