860c860
< * FUNCTION: AcpiNsMapHandleToNode
---
> * FUNCTION: AcpiNsValidateHandle
862c862,863
< * PARAMETERS: Handle - Handle to be converted to an Node
---
> * PARAMETERS: Handle - Handle to be validated and typecast to a
> * namespace node.
864c865
< * RETURN: A Name table entry pointer
---
> * RETURN: A pointer to a namespace node
866c867,868
< * DESCRIPTION: Convert a namespace handle to a real Node
---
> * DESCRIPTION: Convert a namespace handle to a namespace node. Handles special
> * cases for the root node.
868c870
< * Note: Real integer handles would allow for more verification
---
> * NOTE: Real integer handles would allow for more verification
870c872,874
< * more (and perhaps unnecessary) overhead.
---
> * more overhead and has not been necessary to this point. Drivers
> * holding handles are typically notified before a node becomes invalid
> * due to a table unload.
872,874d875
< * The current implemenation is basically a placeholder until such time comes
< * that it is needed.
< *
878c879
< AcpiNsMapHandleToNode (
---
> AcpiNsValidateHandle (
905,946d905
< * FUNCTION: AcpiNsConvertEntryToHandle
< *
< * PARAMETERS: Node - Node to be converted to a Handle
< *
< * RETURN: A user handle
< *
< * DESCRIPTION: Convert a real Node to a namespace handle
< *
< ******************************************************************************/
<
< ACPI_HANDLE
< AcpiNsConvertEntryToHandle (
< ACPI_NAMESPACE_NODE *Node)
< {
<
<
< /*
< * Simple implementation for now;
< */
< return ((ACPI_HANDLE) Node);
<
<
< /* Example future implementation ---------------------
<
< if (!Node)
< {
< return (NULL);
< }
<
< if (Node == AcpiGbl_RootNode)
< {
< return (ACPI_ROOT_OBJECT);
< }
<
<
< return ((ACPI_HANDLE) Node);
< ------------------------------------------------------*/
< }
<
<
< /*******************************************************************************
< *