nsutils.c (193529) | nsutils.c (200553) |
---|---|
1/****************************************************************************** 2 * 3 * Module Name: nsutils - Utilities for accessing ACPI namespace, accessing 4 * parents and siblings and Scope manipulation 5 * 6 *****************************************************************************/ 7 8/****************************************************************************** --- 843 unchanged lines hidden (view full) --- 852 } 853 854 return_ACPI_STATUS (AE_OK); 855} 856 857 858/******************************************************************************* 859 * | 1/****************************************************************************** 2 * 3 * Module Name: nsutils - Utilities for accessing ACPI namespace, accessing 4 * parents and siblings and Scope manipulation 5 * 6 *****************************************************************************/ 7 8/****************************************************************************** --- 843 unchanged lines hidden (view full) --- 852 } 853 854 return_ACPI_STATUS (AE_OK); 855} 856 857 858/******************************************************************************* 859 * |
860 * FUNCTION: AcpiNsMapHandleToNode | 860 * FUNCTION: AcpiNsValidateHandle |
861 * | 861 * |
862 * PARAMETERS: Handle - Handle to be converted to an Node | 862 * PARAMETERS: Handle - Handle to be validated and typecast to a 863 * namespace node. |
863 * | 864 * |
864 * RETURN: A Name table entry pointer | 865 * RETURN: A pointer to a namespace node |
865 * | 866 * |
866 * DESCRIPTION: Convert a namespace handle to a real Node | 867 * DESCRIPTION: Convert a namespace handle to a namespace node. Handles special 868 * cases for the root node. |
867 * | 869 * |
868 * Note: Real integer handles would allow for more verification | 870 * NOTE: Real integer handles would allow for more verification |
869 * and keep all pointers within this subsystem - however this introduces | 871 * and keep all pointers within this subsystem - however this introduces |
870 * more (and perhaps unnecessary) overhead. | 872 * more overhead and has not been necessary to this point. Drivers 873 * holding handles are typically notified before a node becomes invalid 874 * due to a table unload. |
871 * | 875 * |
872 * The current implemenation is basically a placeholder until such time comes 873 * that it is needed. 874 * | |
875 ******************************************************************************/ 876 877ACPI_NAMESPACE_NODE * | 876 ******************************************************************************/ 877 878ACPI_NAMESPACE_NODE * |
878AcpiNsMapHandleToNode ( | 879AcpiNsValidateHandle ( |
879 ACPI_HANDLE Handle) 880{ 881 882 ACPI_FUNCTION_ENTRY (); 883 884 885 /* Parameter validation */ 886 --- 10 unchanged lines hidden (view full) --- 897 } 898 899 return (ACPI_CAST_PTR (ACPI_NAMESPACE_NODE, Handle)); 900} 901 902 903/******************************************************************************* 904 * | 880 ACPI_HANDLE Handle) 881{ 882 883 ACPI_FUNCTION_ENTRY (); 884 885 886 /* Parameter validation */ 887 --- 10 unchanged lines hidden (view full) --- 898 } 899 900 return (ACPI_CAST_PTR (ACPI_NAMESPACE_NODE, Handle)); 901} 902 903 904/******************************************************************************* 905 * |
905 * FUNCTION: AcpiNsConvertEntryToHandle 906 * 907 * PARAMETERS: Node - Node to be converted to a Handle 908 * 909 * RETURN: A user handle 910 * 911 * DESCRIPTION: Convert a real Node to a namespace handle 912 * 913 ******************************************************************************/ 914 915ACPI_HANDLE 916AcpiNsConvertEntryToHandle ( 917 ACPI_NAMESPACE_NODE *Node) 918{ 919 920 921 /* 922 * Simple implementation for now; 923 */ 924 return ((ACPI_HANDLE) Node); 925 926 927/* Example future implementation --------------------- 928 929 if (!Node) 930 { 931 return (NULL); 932 } 933 934 if (Node == AcpiGbl_RootNode) 935 { 936 return (ACPI_ROOT_OBJECT); 937 } 938 939 940 return ((ACPI_HANDLE) Node); 941------------------------------------------------------*/ 942} 943 944 945/******************************************************************************* 946 * | |
947 * FUNCTION: AcpiNsTerminate 948 * 949 * PARAMETERS: none 950 * 951 * RETURN: none 952 * 953 * DESCRIPTION: free memory allocated for namespace and ACPI table storage. 954 * --- 271 unchanged lines hidden --- | 906 * FUNCTION: AcpiNsTerminate 907 * 908 * PARAMETERS: none 909 * 910 * RETURN: none 911 * 912 * DESCRIPTION: free memory allocated for namespace and ACPI table storage. 913 * --- 271 unchanged lines hidden --- |