3.1 Storage Handle

A storage handle refers to a storage instance.

Data type: qsmm_storage_t

This is a type for a storage handle. It is a pointer, so variables of this type can be NULL. The function qsmm_get_actor_storage returns the storage handle of an actor. You can pass a returned handle to API functions taking an argument of qsmm_storage_t type until destroying the actor.

Use the following function to query the number of cycle-summed value types supported by a storage instance referred to by a storage handle.

Function: int qsmm_get_storage_nspval (qsmm_storage_t storage)

This function returns the number of cycle-summed value types supported by storage. That number is the sum of the number of spur types and the number of continuous time types supported by an actor owning storage. The indices of cycle-summed value types for spur types precede the indices of cycle-summed value types for continuous time types.

The field nspur of qsmm_actor_desc_s structure passed when creating an actor specifies the number of supported spur types. The function qsmm_get_actor_nspur returns that number for a created actor. The field ntime of qsmm_actor_desc_s structure passed when creating an actor specifies the number of supported continuous time types. The function qsmm_get_actor_ntime returns that number for a created actor.

A value returned by the function is always non-negative.