mirror of
https://github.com/reactos/reactos.git
synced 2024-09-20 01:31:34 +00:00
c501d8112c
svn path=/branches/aicom-network-fixes/; revision=34994
691 lines
18 KiB
C
691 lines
18 KiB
C
/*******************************************************************************
|
|
*
|
|
* Module Name: nsxfobj - Public interfaces to the ACPI subsystem
|
|
* ACPI Object oriented interfaces
|
|
* $Revision: 1.1 $
|
|
*
|
|
******************************************************************************/
|
|
|
|
/*
|
|
* Copyright (C) 2000, 2001 R. Byron Moore
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
*/
|
|
|
|
|
|
#include <acpi.h>
|
|
|
|
#define _COMPONENT ACPI_NAMESPACE
|
|
MODULE_NAME ("nsxfobj")
|
|
|
|
|
|
/*******************************************************************************
|
|
*
|
|
* FUNCTION: Acpi_evaluate_object
|
|
*
|
|
* PARAMETERS: Handle - Object handle (optional)
|
|
* *Pathname - Object pathname (optional)
|
|
* **Params - List of parameters to pass to
|
|
* method, terminated by NULL.
|
|
* Params itself may be NULL
|
|
* if no parameters are being
|
|
* passed.
|
|
* *Return_object - Where to put method's return value (if
|
|
* any). If NULL, no value is returned.
|
|
*
|
|
* RETURN: Status
|
|
*
|
|
* DESCRIPTION: Find and evaluate the given object, passing the given
|
|
* parameters if necessary. One of "Handle" or "Pathname" must
|
|
* be valid (non-null)
|
|
*
|
|
******************************************************************************/
|
|
|
|
ACPI_STATUS
|
|
acpi_evaluate_object (
|
|
ACPI_HANDLE handle,
|
|
ACPI_STRING pathname,
|
|
ACPI_OBJECT_LIST *param_objects,
|
|
ACPI_BUFFER *return_buffer)
|
|
{
|
|
ACPI_STATUS status;
|
|
ACPI_OPERAND_OBJECT **param_ptr = NULL;
|
|
ACPI_OPERAND_OBJECT *return_obj = NULL;
|
|
ACPI_OPERAND_OBJECT *object_ptr = NULL;
|
|
u32 buffer_space_needed;
|
|
u32 user_buffer_length;
|
|
u32 count;
|
|
u32 i;
|
|
u32 param_length;
|
|
u32 object_length;
|
|
|
|
|
|
/*
|
|
* If there are parameters to be passed to the object
|
|
* (which must be a control method), the external objects
|
|
* must be converted to internal objects
|
|
*/
|
|
|
|
if (param_objects && param_objects->count) {
|
|
/*
|
|
* Allocate a new parameter block for the internal objects
|
|
* Add 1 to count to allow for null terminated internal list
|
|
*/
|
|
|
|
count = param_objects->count;
|
|
param_length = (count + 1) * sizeof (void *);
|
|
object_length = count * sizeof (ACPI_OPERAND_OBJECT);
|
|
|
|
param_ptr = acpi_cm_callocate (param_length + /* Parameter List part */
|
|
object_length); /* Actual objects */
|
|
if (!param_ptr) {
|
|
return (AE_NO_MEMORY);
|
|
}
|
|
|
|
object_ptr = (ACPI_OPERAND_OBJECT *) ((u8 *) param_ptr +
|
|
param_length);
|
|
|
|
/*
|
|
* Init the param array of pointers and NULL terminate
|
|
* the list
|
|
*/
|
|
|
|
for (i = 0; i < count; i++) {
|
|
param_ptr[i] = &object_ptr[i];
|
|
acpi_cm_init_static_object (&object_ptr[i]);
|
|
}
|
|
param_ptr[count] = NULL;
|
|
|
|
/*
|
|
* Convert each external object in the list to an
|
|
* internal object
|
|
*/
|
|
for (i = 0; i < count; i++) {
|
|
status = acpi_cm_copy_eobject_to_iobject (¶m_objects->pointer[i],
|
|
param_ptr[i]);
|
|
|
|
if (ACPI_FAILURE (status)) {
|
|
acpi_cm_delete_internal_object_list (param_ptr);
|
|
return (status);
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
/*
|
|
* Three major cases:
|
|
* 1) Fully qualified pathname
|
|
* 2) No handle, not fully qualified pathname (error)
|
|
* 3) Valid handle
|
|
*/
|
|
|
|
if ((pathname) &&
|
|
(acpi_ns_valid_root_prefix (pathname[0]))) {
|
|
/*
|
|
* The path is fully qualified, just evaluate by name
|
|
*/
|
|
status = acpi_ns_evaluate_by_name (pathname, param_ptr, &return_obj);
|
|
}
|
|
|
|
else if (!handle) {
|
|
/*
|
|
* A handle is optional iff a fully qualified pathname
|
|
* is specified. Since we've already handled fully
|
|
* qualified names above, this is an error
|
|
*/
|
|
|
|
|
|
|
|
status = AE_BAD_PARAMETER;
|
|
}
|
|
|
|
else {
|
|
/*
|
|
* We get here if we have a handle -- and if we have a
|
|
* pathname it is relative. The handle will be validated
|
|
* in the lower procedures
|
|
*/
|
|
|
|
if (!pathname) {
|
|
/*
|
|
* The null pathname case means the handle is for
|
|
* the actual object to be evaluated
|
|
*/
|
|
status = acpi_ns_evaluate_by_handle (handle, param_ptr, &return_obj);
|
|
}
|
|
|
|
else {
|
|
/*
|
|
* Both a Handle and a relative Pathname
|
|
*/
|
|
status = acpi_ns_evaluate_relative (handle, pathname, param_ptr,
|
|
&return_obj);
|
|
}
|
|
}
|
|
|
|
|
|
/*
|
|
* If we are expecting a return value, and all went well above,
|
|
* copy the return value to an external object.
|
|
*/
|
|
|
|
if (return_buffer) {
|
|
user_buffer_length = return_buffer->length;
|
|
return_buffer->length = 0;
|
|
|
|
if (return_obj) {
|
|
if (VALID_DESCRIPTOR_TYPE (return_obj, ACPI_DESC_TYPE_NAMED)) {
|
|
/*
|
|
* If we got an Node as a return object,
|
|
* this means the object we are evaluating
|
|
* has nothing interesting to return (such
|
|
* as a mutex, etc.) We return an error
|
|
* because these types are essentially
|
|
* unsupported by this interface. We
|
|
* don't check up front because this makes
|
|
* it easier to add support for various
|
|
* types at a later date if necessary.
|
|
*/
|
|
status = AE_TYPE;
|
|
return_obj = NULL; /* No need to delete an Node */
|
|
}
|
|
|
|
if (ACPI_SUCCESS (status)) {
|
|
/*
|
|
* Find out how large a buffer is needed
|
|
* to contain the returned object
|
|
*/
|
|
status = acpi_cm_get_object_size (return_obj,
|
|
&buffer_space_needed);
|
|
if (ACPI_SUCCESS (status)) {
|
|
/*
|
|
* Check if there is enough room in the
|
|
* caller's buffer
|
|
*/
|
|
|
|
if (user_buffer_length < buffer_space_needed) {
|
|
/*
|
|
* Caller's buffer is too small, can't
|
|
* give him partial results fail the call
|
|
* but return the buffer size needed
|
|
*/
|
|
|
|
return_buffer->length = buffer_space_needed;
|
|
status = AE_BUFFER_OVERFLOW;
|
|
}
|
|
|
|
else {
|
|
/*
|
|
* We have enough space for the object, build it
|
|
*/
|
|
status = acpi_cm_copy_iobject_to_eobject (return_obj,
|
|
return_buffer);
|
|
return_buffer->length = buffer_space_needed;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
/* Delete the return and parameter objects */
|
|
|
|
if (return_obj) {
|
|
/*
|
|
* Delete the internal return object. (Or at least
|
|
* decrement the reference count by one)
|
|
*/
|
|
acpi_cm_remove_reference (return_obj);
|
|
}
|
|
|
|
/*
|
|
* Free the input parameter list (if we created one),
|
|
*/
|
|
|
|
if (param_ptr) {
|
|
/* Free the allocated parameter block */
|
|
|
|
acpi_cm_delete_internal_object_list (param_ptr);
|
|
}
|
|
|
|
return (status);
|
|
}
|
|
|
|
|
|
/*******************************************************************************
|
|
*
|
|
* FUNCTION: Acpi_get_next_object
|
|
*
|
|
* PARAMETERS: Type - Type of object to be searched for
|
|
* Parent - Parent object whose children we are getting
|
|
* Last_child - Previous child that was found.
|
|
* The NEXT child will be returned
|
|
* Ret_handle - Where handle to the next object is placed
|
|
*
|
|
* RETURN: Status
|
|
*
|
|
* DESCRIPTION: Return the next peer object within the namespace. If Handle is
|
|
* valid, Scope is ignored. Otherwise, the first object within
|
|
* Scope is returned.
|
|
*
|
|
******************************************************************************/
|
|
|
|
ACPI_STATUS
|
|
acpi_get_next_object (
|
|
ACPI_OBJECT_TYPE type,
|
|
ACPI_HANDLE parent,
|
|
ACPI_HANDLE child,
|
|
ACPI_HANDLE *ret_handle)
|
|
{
|
|
ACPI_STATUS status = AE_OK;
|
|
ACPI_NAMESPACE_NODE *node;
|
|
ACPI_NAMESPACE_NODE *parent_node = NULL;
|
|
ACPI_NAMESPACE_NODE *child_node = NULL;
|
|
|
|
|
|
/* Parameter validation */
|
|
|
|
if (type > ACPI_TYPE_MAX) {
|
|
return (AE_BAD_PARAMETER);
|
|
}
|
|
|
|
acpi_cm_acquire_mutex (ACPI_MTX_NAMESPACE);
|
|
|
|
/* If null handle, use the parent */
|
|
|
|
if (!child) {
|
|
/* Start search at the beginning of the specified scope */
|
|
|
|
parent_node = acpi_ns_convert_handle_to_entry (parent);
|
|
if (!parent_node) {
|
|
status = AE_BAD_PARAMETER;
|
|
goto unlock_and_exit;
|
|
}
|
|
}
|
|
|
|
/* Non-null handle, ignore the parent */
|
|
|
|
else {
|
|
/* Convert and validate the handle */
|
|
|
|
child_node = acpi_ns_convert_handle_to_entry (child);
|
|
if (!child_node) {
|
|
status = AE_BAD_PARAMETER;
|
|
goto unlock_and_exit;
|
|
}
|
|
}
|
|
|
|
|
|
/* Internal function does the real work */
|
|
|
|
node = acpi_ns_get_next_object ((OBJECT_TYPE_INTERNAL) type,
|
|
parent_node, child_node);
|
|
if (!node) {
|
|
status = AE_NOT_FOUND;
|
|
goto unlock_and_exit;
|
|
}
|
|
|
|
if (ret_handle) {
|
|
*ret_handle = acpi_ns_convert_entry_to_handle (node);
|
|
}
|
|
|
|
|
|
unlock_and_exit:
|
|
|
|
acpi_cm_release_mutex (ACPI_MTX_NAMESPACE);
|
|
return (status);
|
|
}
|
|
|
|
|
|
/*******************************************************************************
|
|
*
|
|
* FUNCTION: Acpi_get_type
|
|
*
|
|
* PARAMETERS: Handle - Handle of object whose type is desired
|
|
* *Ret_type - Where the type will be placed
|
|
*
|
|
* RETURN: Status
|
|
*
|
|
* DESCRIPTION: This routine returns the type associatd with a particular handle
|
|
*
|
|
******************************************************************************/
|
|
|
|
ACPI_STATUS
|
|
acpi_get_type (
|
|
ACPI_HANDLE handle,
|
|
ACPI_OBJECT_TYPE *ret_type)
|
|
{
|
|
ACPI_NAMESPACE_NODE *node;
|
|
|
|
|
|
/* Parameter Validation */
|
|
|
|
if (!ret_type) {
|
|
return (AE_BAD_PARAMETER);
|
|
}
|
|
|
|
/*
|
|
* Special case for the predefined Root Node
|
|
* (return type ANY)
|
|
*/
|
|
if (handle == ACPI_ROOT_OBJECT) {
|
|
*ret_type = ACPI_TYPE_ANY;
|
|
return (AE_OK);
|
|
}
|
|
|
|
acpi_cm_acquire_mutex (ACPI_MTX_NAMESPACE);
|
|
|
|
/* Convert and validate the handle */
|
|
|
|
node = acpi_ns_convert_handle_to_entry (handle);
|
|
if (!node) {
|
|
acpi_cm_release_mutex (ACPI_MTX_NAMESPACE);
|
|
return (AE_BAD_PARAMETER);
|
|
}
|
|
|
|
*ret_type = node->type;
|
|
|
|
|
|
acpi_cm_release_mutex (ACPI_MTX_NAMESPACE);
|
|
return (AE_OK);
|
|
}
|
|
|
|
|
|
/*******************************************************************************
|
|
*
|
|
* FUNCTION: Acpi_get_parent
|
|
*
|
|
* PARAMETERS: Handle - Handle of object whose parent is desired
|
|
* Ret_handle - Where the parent handle will be placed
|
|
*
|
|
* RETURN: Status
|
|
*
|
|
* DESCRIPTION: Returns a handle to the parent of the object represented by
|
|
* Handle.
|
|
*
|
|
******************************************************************************/
|
|
|
|
ACPI_STATUS
|
|
acpi_get_parent (
|
|
ACPI_HANDLE handle,
|
|
ACPI_HANDLE *ret_handle)
|
|
{
|
|
ACPI_NAMESPACE_NODE *node;
|
|
ACPI_STATUS status = AE_OK;
|
|
|
|
|
|
/* No trace macro, too verbose */
|
|
|
|
|
|
if (!ret_handle) {
|
|
return (AE_BAD_PARAMETER);
|
|
}
|
|
|
|
/* Special case for the predefined Root Node (no parent) */
|
|
|
|
if (handle == ACPI_ROOT_OBJECT) {
|
|
return (AE_NULL_ENTRY);
|
|
}
|
|
|
|
|
|
acpi_cm_acquire_mutex (ACPI_MTX_NAMESPACE);
|
|
|
|
/* Convert and validate the handle */
|
|
|
|
node = acpi_ns_convert_handle_to_entry (handle);
|
|
if (!node) {
|
|
status = AE_BAD_PARAMETER;
|
|
goto unlock_and_exit;
|
|
}
|
|
|
|
|
|
/* Get the parent entry */
|
|
|
|
*ret_handle =
|
|
acpi_ns_convert_entry_to_handle (acpi_ns_get_parent_object (node));
|
|
|
|
/* Return exeption if parent is null */
|
|
|
|
if (!acpi_ns_get_parent_object (node)) {
|
|
status = AE_NULL_ENTRY;
|
|
}
|
|
|
|
|
|
unlock_and_exit:
|
|
|
|
acpi_cm_release_mutex (ACPI_MTX_NAMESPACE);
|
|
return (status);
|
|
}
|
|
|
|
|
|
/*******************************************************************************
|
|
*
|
|
* FUNCTION: Acpi_walk_namespace
|
|
*
|
|
* PARAMETERS: Type - ACPI_OBJECT_TYPE to search for
|
|
* Start_object - Handle in namespace where search begins
|
|
* Max_depth - Depth to which search is to reach
|
|
* User_function - Called when an object of "Type" is found
|
|
* Context - Passed to user function
|
|
* Return_value - Location where return value of
|
|
* User_function is put if terminated early
|
|
*
|
|
* RETURNS Return value from the User_function if terminated early.
|
|
* Otherwise, returns NULL.
|
|
*
|
|
* DESCRIPTION: Performs a modified depth-first walk of the namespace tree,
|
|
* starting (and ending) at the object specified by Start_handle.
|
|
* The User_function is called whenever an object that matches
|
|
* the type parameter is found. If the user function returns
|
|
* a non-zero value, the search is terminated immediately and this
|
|
* value is returned to the caller.
|
|
*
|
|
* The point of this procedure is to provide a generic namespace
|
|
* walk routine that can be called from multiple places to
|
|
* provide multiple services; the User Function can be tailored
|
|
* to each task, whether it is a print function, a compare
|
|
* function, etc.
|
|
*
|
|
******************************************************************************/
|
|
|
|
ACPI_STATUS
|
|
acpi_walk_namespace (
|
|
ACPI_OBJECT_TYPE type,
|
|
ACPI_HANDLE start_object,
|
|
u32 max_depth,
|
|
WALK_CALLBACK user_function,
|
|
void *context,
|
|
void **return_value)
|
|
{
|
|
ACPI_STATUS status;
|
|
|
|
|
|
/* Parameter validation */
|
|
|
|
if ((type > ACPI_TYPE_MAX) ||
|
|
(!max_depth) ||
|
|
(!user_function)) {
|
|
return (AE_BAD_PARAMETER);
|
|
}
|
|
|
|
/*
|
|
* Lock the namespace around the walk.
|
|
* The namespace will be unlocked/locked around each call
|
|
* to the user function - since this function
|
|
* must be allowed to make Acpi calls itself.
|
|
*/
|
|
|
|
acpi_cm_acquire_mutex (ACPI_MTX_NAMESPACE);
|
|
status = acpi_ns_walk_namespace ((OBJECT_TYPE_INTERNAL) type,
|
|
start_object, max_depth,
|
|
NS_WALK_UNLOCK,
|
|
user_function, context,
|
|
return_value);
|
|
|
|
acpi_cm_release_mutex (ACPI_MTX_NAMESPACE);
|
|
|
|
return (status);
|
|
}
|
|
|
|
|
|
/*******************************************************************************
|
|
*
|
|
* FUNCTION: Acpi_ns_get_device_callback
|
|
*
|
|
* PARAMETERS: Callback from Acpi_get_device
|
|
*
|
|
* RETURN: Status
|
|
*
|
|
* DESCRIPTION: Takes callbacks from Walk_namespace and filters out all non-
|
|
* present devices, or if they specified a HID, it filters based
|
|
* on that.
|
|
*
|
|
******************************************************************************/
|
|
|
|
static ACPI_STATUS
|
|
acpi_ns_get_device_callback (
|
|
ACPI_HANDLE obj_handle,
|
|
u32 nesting_level,
|
|
void *context,
|
|
void **return_value)
|
|
{
|
|
ACPI_STATUS status;
|
|
ACPI_NAMESPACE_NODE *node;
|
|
u32 flags;
|
|
DEVICE_ID device_id;
|
|
ACPI_GET_DEVICES_INFO *info;
|
|
|
|
|
|
info = context;
|
|
|
|
acpi_cm_acquire_mutex (ACPI_MTX_NAMESPACE);
|
|
|
|
node = acpi_ns_convert_handle_to_entry (obj_handle);
|
|
|
|
acpi_cm_release_mutex (ACPI_MTX_NAMESPACE);
|
|
|
|
if (!node) {
|
|
return (AE_BAD_PARAMETER);
|
|
}
|
|
|
|
/*
|
|
* Run _STA to determine if device is present
|
|
*/
|
|
|
|
status = acpi_cm_execute_STA (node, &flags);
|
|
if (ACPI_FAILURE (status)) {
|
|
return (status);
|
|
}
|
|
|
|
if (!(flags & 0x01)) {
|
|
/* don't return at the device or children of the device if not there */
|
|
|
|
return (AE_CTRL_DEPTH);
|
|
}
|
|
|
|
/*
|
|
* Filter based on device HID
|
|
*/
|
|
if (info->hid != NULL) {
|
|
status = acpi_cm_execute_HID (node, &device_id);
|
|
|
|
if (status == AE_NOT_FOUND) {
|
|
return (AE_OK);
|
|
}
|
|
|
|
else if (ACPI_FAILURE (status)) {
|
|
return (status);
|
|
}
|
|
|
|
if (STRNCMP (device_id.buffer, info->hid, sizeof (device_id.buffer)) != 0) {
|
|
return (AE_OK);
|
|
}
|
|
}
|
|
|
|
info->user_function (obj_handle, nesting_level, info->context, return_value);
|
|
|
|
return (AE_OK);
|
|
}
|
|
|
|
|
|
/*******************************************************************************
|
|
*
|
|
* FUNCTION: Acpi_get_devices
|
|
*
|
|
* PARAMETERS: HID - HID to search for. Can be NULL.
|
|
* User_function - Called when a matching object is found
|
|
* Context - Passed to user function
|
|
* Return_value - Location where return value of
|
|
* User_function is put if terminated early
|
|
*
|
|
* RETURNS Return value from the User_function if terminated early.
|
|
* Otherwise, returns NULL.
|
|
*
|
|
* DESCRIPTION: Performs a modified depth-first walk of the namespace tree,
|
|
* starting (and ending) at the object specified by Start_handle.
|
|
* The User_function is called whenever an object that matches
|
|
* the type parameter is found. If the user function returns
|
|
* a non-zero value, the search is terminated immediately and this
|
|
* value is returned to the caller.
|
|
*
|
|
* This is a wrapper for Walk_namespace, but the callback performs
|
|
* additional filtering. Please see Acpi_get_device_callback.
|
|
*
|
|
******************************************************************************/
|
|
|
|
ACPI_STATUS
|
|
acpi_get_devices (
|
|
NATIVE_CHAR *HID,
|
|
WALK_CALLBACK user_function,
|
|
void *context,
|
|
void **return_value)
|
|
{
|
|
ACPI_STATUS status;
|
|
ACPI_GET_DEVICES_INFO info;
|
|
|
|
|
|
/* Parameter validation */
|
|
|
|
if (!user_function) {
|
|
return (AE_BAD_PARAMETER);
|
|
}
|
|
|
|
/*
|
|
* We're going to call their callback from OUR callback, so we need
|
|
* to know what it is, and their context parameter.
|
|
*/
|
|
info.context = context;
|
|
info.user_function = user_function;
|
|
info.hid = HID;
|
|
|
|
/*
|
|
* Lock the namespace around the walk.
|
|
* The namespace will be unlocked/locked around each call
|
|
* to the user function - since this function
|
|
* must be allowed to make Acpi calls itself.
|
|
*/
|
|
|
|
acpi_cm_acquire_mutex (ACPI_MTX_NAMESPACE);
|
|
status = acpi_ns_walk_namespace (ACPI_TYPE_DEVICE,
|
|
ACPI_ROOT_OBJECT, ACPI_UINT32_MAX,
|
|
NS_WALK_UNLOCK,
|
|
acpi_ns_get_device_callback, &info,
|
|
return_value);
|
|
|
|
acpi_cm_release_mutex (ACPI_MTX_NAMESPACE);
|
|
|
|
return (status);
|
|
}
|