/** @file\r
- DXE Library.\r
+ This library implement library class DxeServiceTableLib.\r
+ It produce EFI_DXE_SERVICE pointer in global variable gDS in library's constructure.\r
+ \r
+ A DXE driver can use gDS pointer to access services in EFI_DXE_SERVICE, if this\r
+ DXE driver declare that use DxeServicesTableLib library class and link to this \r
+ library instance.\r
\r
- Copyright (c) 2006, Intel Corporation<BR>\r
- All rights reserved. This program and the accompanying materials \r
- are licensed and made available under the terms and conditions of the BSD License \r
- which accompanies this distribution. The full text of the license may be found at \r
- http://opensource.org/licenses/bsd-license.php \r
+ Please attention this library instance can not be used util EFI_SYSTEM_TABLE was \r
+ initialized.\r
+ \r
+ This library contains contruct function to retrieve EFI_DXE_SERIVCE, this construct\r
+ function will be invoked in DXE driver's autogen file.\r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+ Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>\r
+ This program and the accompanying materials\r
+ are licensed and made available under the terms and conditions of the BSD License\r
+ which accompanies this distribution. The full text of the license may be found at\r
+ http://opensource.org/licenses/bsd-license.php\r
\r
- Module Name: DxeServicesTableLib.c\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
**/\r
\r
+#include <PiDxe.h>\r
+#include <Guid/DxeServices.h>\r
+#include <Library/DxeServicesTableLib.h>\r
+#include <Library/DebugLib.h>\r
+#include <Library/UefiLib.h>\r
\r
-\r
+//\r
+// Cache copy of the DXE Services Table\r
+//\r
EFI_DXE_SERVICES *gDS = NULL;\r
\r
/**\r
+ The constructor function caches the pointer of DXE Services Table.\r
+\r
+ The constructor function caches the pointer of DXE Services Table.\r
+ It will ASSERT() if that operation fails.\r
+ It will ASSERT() if the pointer of DXE Services Table is NULL.\r
+ It will always return EFI_SUCCESS.\r
+\r
+ @param ImageHandle The firmware allocated handle for the EFI image.\r
+ @param SystemTable A pointer to the EFI System Table.\r
+\r
+ @retval EFI_SUCCESS The constructor always returns EFI_SUCCESS.\r
+\r
**/\r
EFI_STATUS\r
+EFIAPI\r
DxeServicesTableLibConstructor (\r
IN EFI_HANDLE ImageHandle,\r
IN EFI_SYSTEM_TABLE *SystemTable\r
{\r
EFI_STATUS Status;\r
\r
+ //\r
+ // Cache copy of the DXE Services Table\r
+ //\r
Status = EfiGetSystemConfigurationTable (&gEfiDxeServicesTableGuid, (VOID **) &gDS);\r
ASSERT_EFI_ERROR (Status);\r
ASSERT (gDS != NULL);\r