Methods

Method Evaluation. More...

Collaboration diagram for Methods:

Detailed Description

Method Evaluation.

Functions
aml_object_t *	aml_method_invoke (aml_state_t *parentState, aml_method_t *method, aml_object_t **args)
	Invoke a method with the given arguments.

Function Documentation

aml_method_invoke()

aml_object_t * aml_method_invoke	(	aml_state_t *	parentState,
		aml_method_t *	method,
		aml_object_t **	args
	)

Invoke a method with the given arguments.

Return values are a bit more complex then the spec suggests. The spec leaves "implicit returns", as in the method just ends without a Return statement, undefined. In practice this means we can do whatever we want.

However, since ACPICA is the standard and they allow for "implicit returns" such that the last evaluated expression is returned if there is no explicit Return statement, we just do what they do. Thus the return value will be set to a a copy of the last evaluated expression or a explicitly returned object.

If a method returns without implicitly or explicitly returning a value, a Integer object of value 0 with the AML_OBJECT_EXCEPTION_ON_USE flag set is returned.

Methods return a copy of the result not a reference to the actual object. See section 19.6.120.

Technically if a method is non-serialized we are not supposed to allow recursive calls to it to create named objects that where created in the previous invocation, however allowing this does not cause any issues in practice and makes the implementation a lot simpler... so i dont care.

See also

Section 5.2 of the ACPICA reference for more details.

Section 19.6.85 of the ACPI specification for more details.

aml_overlay_t for more details about the parent overlay.

Parameters

parentState	The current AML state, this will not be used for anything other than getting the parent overlay.
method	Pointer to the method to invoke.
args	Array of pointers to the argument objects, can be NULL, must be null-terminated.

Returns

On success, the return value of the method. On failure, ERR and errno is set.

Definition at line 11 of file method.c.

Here is the call graph for this function:

Here is the caller graph for this function: