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.


dfhs3_SMMCinquire_element_length.html | Timestamp icon Last updated: Monday, 5 June 2017