(v13) D_GEN_BOOT

This page applies to Harlequin v13.1r0 and later; and to Harlequin MultiRIP but not Harlequin Core

D_GEN_BOOT Selector

Parameter: GenericBootParam *param

Call type: Single‐call

This is the next startup call made to an input plugin, after D_GET_IDENTITY .

It is used only to determine the amount of memory the RIP should allocate for the plugin as a whole. (Other memory can be allocated to each channel class and to each channel. See (v13) The ChannelClassDescription structure .)

TEXT

      typedef struct genericBootParam { int32 version ;
      int32 globalStateSizeRequired ;
    } GenericBootParam ;

Note: The globalState pointer in the IPPluginContext structure passed to the plugin will still not be initialized at this point. Once the D_GEN_BOOT call is complete, the global state memory requested should have been allocated. At the following call, D_IP_PLUGIN_INITIALISE , the pointer should be available.

version

The version field should be ignored.

globalStateSizeRequired

The plugin should set this to the number of bytes of memory that should be allocated to it. If no memory is required, it should set this to zero.