SPBlocksSuite Struct Reference
[API Suite List]

This suite provides basic memory management for PICA (the Adobe plug-in manager), with debugging capability for the development version of the application. More...

#include <SPBlocks.h>

List of all members.

Public Attributes
SPAPI SPErr(*	AllocateBlock )(size_t size, const char *debug, void **block)
	Allocates a block of memory.
SPAPI SPErr(*	FreeBlock )(void *block)
	Frees a block of memory allocated with AllocateBlock().
SPAPI SPErr(*	ReallocateBlock )(void *block, size_t newSize, const char *debug, void **rblock)
	Reallocates a block previously allocated with AllocateBlock().

---

Detailed Description

This suite provides basic memory management for PICA (the Adobe plug-in manager), with debugging capability for the development version of the application.

Unlike other suites, this suite is available during plug-in load and unload operations. You can acquire it in response to a PICA access (kSPAccessCaller) or property (kSPPropertiesCaller) message, and use it to allocate and free memory for the plug-in you are loading or unloading.

• Acquire this suite using SPBasicSuite::AcquireSuite() with the constants kSPBlocksSuite and kSPBlocksSuiteVersion.

---

Member Data Documentation

SPAPI SPErr(* SPBlocksSuite::AllocateBlock)(size_t size, const char *debug, void **block)

Allocates a block of memory.

Parameters:

	size	The number of bytes.
	debug	Optional. A tag for the block, available in the development version of the application. Otherwise ignored. See SPBlockDebugSuite::GetBlockDebug().
	block	[out] A buffer in which to return the block pointer.

See also:

SPBasicSuite::AllocateBlock()

Referenced by ai::SPAlloc::AllocateBlock().

SPAPI SPErr(* SPBlocksSuite::FreeBlock)(void *block)

Frees a block of memory allocated with AllocateBlock().

Parameters:

block

The block pointer.

See also:

SPBasicSuite::FreeBlock()

Referenced by ai::SPAlloc::DeleteBlock().

SPAPI SPErr(* SPBlocksSuite::ReallocateBlock)(void *block, size_t newSize, const char *debug, void **rblock)

Reallocates a block previously allocated with AllocateBlock().

Increases the size without changing the location, if possible.

Parameters:

	block	The block pointer.
	newSize	The new number of bytes.
	debug	Optional. A tag for the block, available in the development version of the application. Otherwise ignored. See SPBlockDebugSuite::GetBlockDebug().
	newblock	[out] A buffer in which to return the new block pointer.

See also:

SPBasicSuite::ReallocateBlock()

---

The documentation for this struct was generated from the following file:

• SPBlocks.h