------------------------------------------------------------------------------------------------
声明：本文性质不属于我的原创，文中主体属于我对PS SKD文档的翻译，包含自己的整理。
-------------------------------------------------------------------------------------------------
在上一篇文章中我们讲解了PS提供的CallBack函数分为两类，即（1）直接可以从参数中获得的一些CallBack函数，称为Direct CallBacks，比如AdvanceStateProc（要求PS立即更新参数中的数据），DisplayPixelsProc（在某HDC表面绘制像素），TestAbortProc（测试用户是否取消，例如按下Esc）等等。（2）被分类封装的回调函数集（CallBack Suites）。由于回调函数增长的越来越多，因此为了有效的组织和管理它们，PS把他们按照功能分类成多组，每一组称为一个Suit（包含一组回调函数）。在前文中我们讲解了和PS脚本系统相关的Suit。下面我们就将继续讲解其他的重要Suit。
在这里，我们再一次强调CallBack的含义，所谓“back”，只得是我们编好的插件，将会被PS主动调用（这种调用即常规的正向调用）。而我们在被PS调用的过程中可以调用PS中的一些函数（“被调用模块”反向调用“调用模块”中的函数），这些函数的地址我们通过PS传递给我们的参数获取，因此这个调用过程称为回调。
Callback Suites：指的是PS 4.0以及早期版本的回调函数。
（1）PS 4.0及早期版本的Buffer suite：（缓冲相关函数集）
由于插件是以DLL导出函数的形式存在着。而内存管理的重任则是宿主（PS）进行管理和协调。因此我们的插件在进行处理前通常需要与PS进行内存需求的“谈判”。Buffer suit提供了一种取代以往版本的内存管理函数，使PS为我们分配和释放内存。
在早期版本中，PS插件用一种非常简单的机制和PS就内存需求进行交流：即让插件自己指定要预留的内存大小，然后PS将为该插件保留一块内存。
这种方法有两个问题。第一，这块内存在插件的整个执行周期内都被保留。第二，插件仍然可能遇到来自PS的内存限制。例如，PS 2.5，在大内存配置下，将在启动时使用NewPtr调用来分配大部分内存，并且这些内存只能使用Buffer suit才能获取。
如果一个插件使用GlobalAlloc（windows）或者NewPtr（Mac OS）分配大部分内存，该企图会失败并且导致PS开始双向交换，从而降低性能。Buffer Suite可以避免一些内存计算，简化Acquire，滤镜，Format插件的准备过程。
对大多数类型插件来说，内存分配可以延迟到他们实际需要的时刻。不幸的是，对于导出（Export）插件来说虽然内存是PS来申请的，但插件必须保持对它的使用跟踪。也就是说对Buffer Suite对Export插件提供的帮助不大。
下面我开始介绍Buffer Suite中的函数：
◆BufferSpaceProc()：
函数声明：
MACPASCAL int32 (*BufferSpaceProc) (void);
该方法返回可以获得的内存空间大小。这些空间可能是一些碎片组成，因此一次性的申请该大小可能会失败。
◆AllocateBufferProc()
函数声明：
MACPASCAL OSErr (*AllocateBufferProc) (int32 size, BufferID *buffer);
未知数据的内存指针称为BufferID。
这个方法将Buffer设置为指定大小的一块内存。如果成功，返回noErr。否则返回一个错误码表明失败。在其他内存被插件锁定（例如滤镜和导出插件的continue调用）期间，内存请求容易失败。
◆FreeBufferProc()
MACPASCAL void (*FreeBufferProc) (BufferID buffer);
释放内存。如果释放后继续使用该内存指针可能导致华丽的崩溃！
◆LockBufferProc()
MACPASCAL Ptr (*LockBufferProc) (BufferID buffer, Boolean moveHigh);
这个函数将会锁定一块内存（防止在内存中被移动），然后返回内存的起始处地址。在Mac OS系统下，moveHigh标志指示是否希望内存块被移动到内存的高端以避免碎片，该标记对Windows无效。
◆UnlockBufferProc()
MACPASCAL void (*UnlockBufferProc) (BufferID buffer);
解锁内存。锁定和解锁使用的是引用计数机制，即一内存允许lock多次，必须unlock相应次数才能实际解锁。
好，有关Buffer Suite就介绍到这里。
（2）Suite PEA CallBacks：在PS 5.0版本中的回调函数集合。
Suite PEA是Adobe的软件使用的插件架构。在上一篇文章中已经有所介绍。这里再复习一下。他实际上是一个PS API的一种“暴露”方式，即通过suites提供给插件。一个suite是一个数据结构的指针，在该数据结构中含有一组函数指针。插件同样可以通过提供自定义的suites来扩展宿主API。
在调用之前，我们先获取一个suite，当不再需要时，则需要释放他。这种做法将保证函数对插件是可用的。得到suite的指针以后，调用它里面的函数的方式是：
sSuite->function();
所以做这件事的一种固定模式如下：
ADMBasicSuite *sADMBasic;
filterParamBlock->sSPBasic->AcquireSuite(
kADMBasicSuite,
kADMBasicSuiteVersion,
&sADMBasic );
sADMBasic->Beep( );
filterParamBlock->sSPBasic->ReleaseSuite(
kADMBasicSuite,
kADMBasicSuiteVersion );
Suite PEA Buffer suite：（描述和前文一致）
BufferNewProc( )
SPAIP Ptr (*BufferNewProc) (size_t *pRequestedSize, size_t minimumSize);
申请新的内存，内存大小由第一个参数指向的数据指定。如果不能分配这么多内存，那么该参数被设置为实际获得的最大的内存大小。如果第一个参数为NULL，那么将分配minimumSIze大小的内存，如果分配失败，该函数将失败并返回NULL。
BufferDisposeProc( )
SPAPI void (*BufferDisposeProc) (Ptr *ppBuffer);
这个方法释放内存，并把其指针设置为NULL。如果参数已经为NULL，则什么也不做。
BufferGetSizeProc( )
SPAPI size_t (*BufferGetSizeProc) (Ptr pBuffer);
这个方法获取指定的内存的尺寸，如果指针有效。
BufferGetSpaceProc( )
SPAPI size_t (*BufferGetSpaceProc) (void);
这个方法获取剩余内存空间的大小，注意可能是不连续的。
（To Be Continued）。--hoodlum1980