SMMC gate, INQUIRE_ELEMENT_LENGTH function
The INQUIRE_ELEMENT_LENGTH function of the SMMC gate is used to obtain the start address and length of the storage element that contains the address that was specified on the input to the call. This function searches only the task-lifetime storage of the current task for the required storage element.
Input Parameters
- ADDRESS | ADDRESS_64
- ADDRESS
- The storage address to inquire on. The address must be in an element of task-lifetime storage of the current task.
- ADDRESS_64
- The 64-bit storage address to inquire on. The address must be in an element of task-lifetime storage of the current task.
Output Parameters
- ELEMENT_LENGTH
- The length of the new element (after it is rounded up to a multiple of the boundary for the subpool).
- REASON
- The following values are returned when RESPONSE is EXCEPTION:
- INVALID_ADDRESS
- The following values are returned when RESPONSE is INVALID:
- INVALID_ADDRESS_ELEMENT
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- ELEMENT_ADDRESS | ELEMENT_ADDRESS_64
- Optional Parameter
- ELEMENT_ADDRESS
- The start address of the element that contains the input address.
- ELEMENT_ADDRESS_64
- The 64-bit start address of the element that contains the input address.