nsxfobj.c File Reference

#include "acpi.h"
#include "accommon.h"
#include "acnamesp.h"

Include dependency graph for nsxfobj.c:

Go to the source code of this file.

Macros
#define	EXPORT_ACPI_INTERFACES
#define	_COMPONENT   ACPI_NAMESPACE

Functions
ACPI_STATUS	AcpiGetType (ACPI_HANDLE Handle, ACPI_OBJECT_TYPE *RetType)
ACPI_STATUS	AcpiGetParent (ACPI_HANDLE Handle, ACPI_HANDLE *RetHandle)
ACPI_STATUS	AcpiGetNextObject (ACPI_OBJECT_TYPE Type, ACPI_HANDLE Parent, ACPI_HANDLE Child, ACPI_HANDLE *RetHandle)

Macro Definition Documentation

_COMPONENT

#define _COMPONENT   ACPI_NAMESPACE

Definition at line 52 of file nsxfobj.c.

EXPORT_ACPI_INTERFACES

#define EXPORT_ACPI_INTERFACES

Definition at line 45 of file nsxfobj.c.

Function Documentation

AcpiGetNextObject()

ACPI_STATUS AcpiGetNextObject	(	ACPI_OBJECT_TYPE	Type,
		ACPI_HANDLE	Parent,
		ACPI_HANDLE	Child,
		ACPI_HANDLE *	RetHandle
	)

Definition at line 209 of file nsxfobj.c.

{
    ACPI_STATUS             Status;
    ACPI_NAMESPACE_NODE     *Node;
    ACPI_NAMESPACE_NODE     *ParentNode = NULL;
    ACPI_NAMESPACE_NODE     *ChildNode = NULL;
 
 
    /* Parameter validation */
 
    if (Type > ACPI_TYPE_EXTERNAL_MAX)
    {
        return (AE_BAD_PARAMETER);
    }
 
    Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
    if (ACPI_FAILURE (Status))
    {
        return (Status);
    }
 
    /* If null handle, use the parent */
 
    if (!Child)
    {
        /* Start search at the beginning of the specified scope */
 
        ParentNode = AcpiNsValidateHandle (Parent);
        if (!ParentNode)
        {
            Status = AE_BAD_PARAMETER;
            goto UnlockAndExit;
        }
    }
    else
    {
        /* Non-null handle, ignore the parent */
        /* Convert and validate the handle */
 
        ChildNode = AcpiNsValidateHandle (Child);
        if (!ChildNode)
        {
            Status = AE_BAD_PARAMETER;
            goto UnlockAndExit;
        }
    }
 
    /* Internal function does the real work */
 
    Node = AcpiNsGetNextNodeTyped (Type, ParentNode, ChildNode);
    if (!Node)
    {
        Status = AE_NOT_FOUND;
        goto UnlockAndExit;
    }
 
    if (RetHandle)
    {
        *RetHandle = ACPI_CAST_PTR (ACPI_HANDLE, Node);
    }
 
 
UnlockAndExit:
 
    (void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
    return (Status);
}

Referenced by acpi_bus_scan().

AcpiGetParent()

ACPI_STATUS AcpiGetParent	(	ACPI_HANDLE	Handle,
		ACPI_HANDLE *	RetHandle
	)

Definition at line 132 of file nsxfobj.c.

{
    ACPI_NAMESPACE_NODE     *Node;
    ACPI_NAMESPACE_NODE     *ParentNode;
    ACPI_STATUS             Status;
 
 
    if (!RetHandle)
    {
        return (AE_BAD_PARAMETER);
    }
 
    /* Special case for the predefined Root Node (no parent) */
 
    if (Handle == ACPI_ROOT_OBJECT)
    {
        return (AE_NULL_ENTRY);
    }
 
    Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
    if (ACPI_FAILURE (Status))
    {
        return (Status);
    }
 
    /* Convert and validate the handle */
 
    Node = AcpiNsValidateHandle (Handle);
    if (!Node)
    {
        Status = AE_BAD_PARAMETER;
        goto UnlockAndExit;
    }
 
    /* Get the parent entry */
 
    ParentNode = Node->Parent;
    *RetHandle = ACPI_CAST_PTR (ACPI_HANDLE, ParentNode);
 
    /* Return exception if parent is null */
 
    if (!ParentNode)
    {
        Status = AE_NULL_ENTRY;
    }
 
 
UnlockAndExit:
 
    (void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
    return (Status);
}

Referenced by acpi_bus_scan(), and AcpiHwBuildPciList().

AcpiGetType()

ACPI_STATUS AcpiGetType	(	ACPI_HANDLE	Handle,
		ACPI_OBJECT_TYPE *	RetType
	)

Definition at line 70 of file nsxfobj.c.

{
    ACPI_NAMESPACE_NODE     *Node;
    ACPI_STATUS             Status;
 
 
    /* Parameter Validation */
 
    if (!RetType)
    {
        return (AE_BAD_PARAMETER);
    }
 
    /* Special case for the predefined Root Node (return type ANY) */
 
    if (Handle == ACPI_ROOT_OBJECT)
    {
        *RetType = ACPI_TYPE_ANY;
        return (AE_OK);
    }
 
    Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
    if (ACPI_FAILURE (Status))
    {
        return (Status);
    }
 
    /* Convert and validate the handle */
 
    Node = AcpiNsValidateHandle (Handle);
    if (!Node)
    {
        (void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
        return (AE_BAD_PARAMETER);
    }
 
    *RetType = Node->Type;
 
    Status = AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
    return (Status);
}

Referenced by acpi_bus_scan(), and AcpiHwGetPciDeviceInfo().