PA_ReturnBlob

version 2003

PA_ReturnBlob (params; blob; len)

Parameter	Type		Description
params	PA_PluginParameters		Parameters received in PluginMain
blob	void*		Pointer to the BLOB data to be returned
len	long		BLOB size in bytes

The routine PA_ReturnBlob sets the returned value of the plug-in routine to the data pointed to by the handle blob. After the call, blob still belongs to the plug-in and you can dispose of it.

Be sure that the BLOB is duplicated to the result value with this call. You can dispose of it once you have finished working with it. If you simply want to return the handle itself without duplicating the BLOB data, use PA_ReturnBlobHandle.

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

Create, fill (with "1"), and return a BLOB.

   void ReturnBasicBlob(PluginParameters params)
   {
      char   *buffer;
      long   size;

      buffer = malloc(1024);
      if(buffer)
      {
         for(i = 0; i < 1024;i++)
            *buffer++ = (char)1;
      // Return the blob
         PA_ReturnBlob(params, buffer, size);
      // We can (and should once finished with it) free the BLOB here
         free (buffer);
      }
   }

Create a new plugin, PA_ReturnBlobHandle.

None.