(v13) Memory allocation

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

The CMM API provides memory allocation and destruction functions via the sw_memory_instance structureless CMM API provides memory allocation and destruction functions via the sw_memory_instance structure pointer, defined in the SDK's memory callback API header swmemapi.h .

The sw_memory_instance structure is an instance of a sw_memory_api API implementation (class):

The RIP constructs a sw_memory_instance structure for its built-in memory allocator, and passes a pointer for this to the CMM init () routine. The RIP also initializes each CMM sw_cmm_instance structure with this memory instance pointer before calling the construct() method. The alloc and free functions provided are expected to be used by alternate CMMs whenever possible rather than OS supplied functions. Failure to implement this may result in difficulties in configuring the RIP memory for optimal performance, especially in memory constrained environments.