Netscape DevEdge

Skip to: [content] [navigation]

TOC PREV NEXT

plug-ins!


NPN_MemFlush


Requests that the browser free a specified amount of memory.

Implemented only on Mac OS.

Syntax

#include <npapi.h>
 
uint32 NPN_MemFlush(uint32 size);
 

Parameters

The function has the following parameters:

size
 
Size of memory, in bytes, to free in the browser's memory space.

Returns

  • If successful, the function returns the amount of freed memory, in bytes.
  • If no memory can be freed, the plug-in returns 0.

Description

The plug-in calls NPN_MemFlush when it is not possible to call NPN_MemAlloc, for example, when calling system APIs that indirectly allocate memory. To request that the browser free as much memory as possible, call NPN_MemFlush repeatedly until it returns 0.

On Mac OS, you can use this method to free memory before calling memory-intensive Mac Toolbox calls.

In general, plug-ins should use NPN_MemAlloc to allocate memory in the browser's memory space, since this function automatically frees cached data if necessary to fulfill the request.

See Also

NPN_MemFlush, NPN_MemFree
 


Netscape Communications
http://developer.netscape.com
TOC PREV NEXT
A+R