PA_SetBlobHandleParameter

version 2003

PA_SetBlobHandleParameter (params; index; hblob)

Parameter	Type		Description
params	PA_PluginParameters	→	Parameters received in PluginMain
index	short	→	Index of the parameter in params
hblob	PA_Handle	→	New BLOB handle

Description

The routine PA_SetBlobHandleParameter sets the value of the BLOB handle in the index parameter in params to hblob .

Pass a handle to the new data in hblob . This can be useful if you no longer need to use the handle as it will not be duplicated, as PA_SertBlobParameter does (which can lead to memory problems for "larger" BLOBs).

The previous BLOB in the parameter is disposed.

WARNING

After the call, the handle belongs to 4D; you must never dispose of it.

See Create a new plug-in for a description of parameter accessors.

NOTE
:

The first parameter starts at index 1

Example

Set a BLOB parameter.

   PA_Handle   h;
   h = PA_NewHandle(kMY_BUFFER_SIZE);
   /* . . . fill the handle . . .*/
   PA_SetBlobHandleParameter(params, index, h);
   // Never call DisposeHandle(h) from now.

Error Handling

None.