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.
See Also
Create a new plugin, PA_SetBlobParameter.
Error Handling
None.