(v13) SWMemoryTag

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

Either SWMemoryTag or SWMemCfgTag (see below) need to be used in any call to SwStart .

SWMemoryTag is used when the RIP memory is obtained by the skin, usually as a single large block of memory. SWMemCfgTag is used to indicate that the RIP should dynamically allocate memory from the Operating System's virtual memory subsystem, managing it within the limits given by the parameters. SWMemCfgTag is much more efficient, so SWMemoryTag should only be used in installations where virtual memory is not available.

The SWMemoryTag element has a value that points to a structure of the following type:

TEXT

                      typedef struct {
                        size_t sizeA; /* Size of the block of memory (arena) */ mps_arena_t arena; /* The memory arena */
                      } SWSTART_MEMORY;

The arena should be an MPS client arena, that is, of arena class mps_arena_class_cl(). The code has an example of this.