Advanced Configuration and Power Interface Specification

Advanced Configuration and Power Interface Specification
Table 19-358 Object Storing and Copying Rules
When Storing an
object of any data
type to this type of
Target location
This action is performed by the
Store operator or any ASL operator
with a Target operand:
This action is performed by the
CopyObject operator:
Method ArgX
variable
Method LocalX
variable
Field Unit or Buffer
Field
Named data object
The object is copied to the destination with no conversion applied, with one
exception. If the ArgX contains an Object Reference, an automatic de-reference
occurs and the object is copied to the target of the Object Reference instead of
overwriting the contents of ArgX
The object is copied to the destination with no conversion applied. Even if LocalX
contains an Object Reference, it is overwritten.
The object is copied to the destination
after implicit result conversion is applied
The object is copied to the destination
after implicit result conversion is applied
to match the existing type of the named
location
Fields permanently retain their type and
cannot be changed. Therefore,
CopyObject can only be used to copy an
object of type Integer or Buffer to fields.
The object and type are copied to the
named location.
19.3.5.9 Rules for Reading and Writing Objects
In the descriptions below, read operations always return the actual object, not a copy of the object in
order that constructs of the form:
Add (Local1, Local2, Local3)
do not create unnecessary copies of Local1 or Local2. Also, this behavior enables the call-byreference
semantics of control method invocation.
19.3.5.9.1 ArgX Objects
1. Read from ArgX parameters
• ObjectReference - Automatic dereference, return the target of the reference. Use of
DeRefOf returns the same.
• Buffer – Return the Buffer. Can create an Index, Field, or Reference to the buffer.
• Package – Return the Package. Can create an Index or Reference to the package.
• All other object types – Return the object.
Example method invocation for the table below:
MTHD (RefOf (Obj), Buf, Pkg, Obj)
Table 19-359 Reading from ArgX Objects
Parameter MTHD ArgX Type Read operation on ArgX Result of read
RefOf (Obj), Reference to object Obj Store (Arg0, …)
CopyObject (Arg0, …)
DeRefOf (Arg0)
Obj
Obj
Obj
798 April, 2015 Version 6.0