added function header
authorvanjeff <vanjeff@6f19259b-4bc3-4df7-8a09-765794883524>
Thu, 13 Jul 2006 01:17:21 +0000 (01:17 +0000)
committervanjeff <vanjeff@6f19259b-4bc3-4df7-8a09-765794883524>
Thu, 13 Jul 2006 01:17:21 +0000 (01:17 +0000)
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@935 6f19259b-4bc3-4df7-8a09-765794883524

MdePkg/Include/Library/PeiServicesTablePointerLib.h
MdePkg/Library/DxeServicesTableLib/DxeServicesTableLib.c
MdePkg/Library/PeiServicesTablePointerLib/PeiServicesTablePointer.c
MdePkg/Library/PeiServicesTablePointerLibMm7/PeiServicesTablePointer.c
MdePkg/Library/UefiBootServicesTableLib/UefiBootServicesTableLib.c
MdePkg/Library/UefiRuntimeServicesTableLib/UefiRuntimeServicesTableLib.c

index 2a346aa..79f27c3 100644 (file)
 #ifndef __PEI_SERVICES_TABLE_POINTER_LIB_H__\r
 #define __PEI_SERVICES_TABLE_POINTER_LIB_H__\r
 \r
+/**\r
+  The function returns the pointer to PEI services.\r
+  \r
+  The function returns the pointer to PEI services. \r
+  It will ASSERT() if the pointer to PEI services is NULL.\r
+\r
+  @retval  The pointer to PeiServices.\r
+\r
+**/\r
 EFI_PEI_SERVICES **\r
 GetPeiServicesTablePointer (\r
   VOID\r
index f130b20..40d4f64 100644 (file)
 EFI_DXE_SERVICES  *gDS      = NULL;\r
 \r
 /**\r
+  The constructor function caches the pointer of System Configuration Table.\r
+  \r
+  The constructor function caches the pointer of System Configuration Table. \r
+  It will ASSERT() if that operation fails.\r
+  It will ASSERT() if the pointer of System Configuration 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
 DxeServicesTableLibConstructor (\r
index b4c13c8..18d8c99 100644 (file)
 \r
 static EFI_PEI_SERVICES  **gPeiServices;\r
 \r
+/**\r
+  The function returns the pointer to PEI services.\r
+  \r
+  The function returns the pointer to PEI services. \r
+  It will ASSERT() if the pointer to PEI services is NULL.\r
+\r
+  @retval  The pointer to PeiServices.\r
+\r
+**/\r
 EFI_PEI_SERVICES **\r
 GetPeiServicesTablePointer (\r
   VOID\r
@@ -27,7 +36,18 @@ GetPeiServicesTablePointer (
   return gPeiServices;\r
 }\r
 \r
+\r
 /**\r
+  The constructor function caches the pointer to PEI services.\r
+  \r
+  The constructor function caches the pointer to PEI services. \r
+  It will always return EFI_SUCCESS.\r
+\r
+  @param  FfsHeader   Pointer to FFS header the loaded driver.\r
+  @param  PeiServices Pointer to the PEI services.\r
+  \r
+  @retval EFI_SUCCESS   The constructor always returns EFI_SUCCESS.\r
+\r
 **/\r
 EFI_STATUS\r
 PeiServicesTablePointerLibConstructor (\r
index f5faf63..5901527 100644 (file)
 **/\r
 \r
 \r
+/**\r
+  The function returns the pointer to PeiServices.\r
+  \r
+  The function returns the pointer to PeiServices. \r
+  It will ASSERT() if the pointer to PeiServices is NULL.\r
+\r
+  @retval  The pointer to PeiServices.\r
 \r
+**/\r
 EFI_PEI_SERVICES **\r
 GetPeiServicesTablePointer (\r
   VOID\r
@@ -29,6 +37,16 @@ GetPeiServicesTablePointer (
 }\r
 \r
 /**\r
+  The constructor function caches the pointer to PEI services.\r
+  \r
+  The constructor function caches the pointer to PEI services. \r
+  It will always return EFI_SUCCESS.\r
+\r
+  @param  FfsHeader   Pointer to FFS header the loaded driver.\r
+  @param  PeiServices Pointer to the PEI services.\r
+  \r
+  @retval EFI_SUCCESS   The constructor always returns EFI_SUCCESS.\r
+\r
 **/\r
 EFI_STATUS\r
 PeiServicesTablePointerLibConstructor (\r
index aa990f7..b45d12d 100644 (file)
@@ -19,6 +19,18 @@ EFI_SYSTEM_TABLE   *gST;
 EFI_BOOT_SERVICES  *gBS;\r
 \r
 /**\r
+  The constructor function caches the pointer of Boot Services Table.\r
+  \r
+  The constructor function caches the pointer of Boot Services Table through System Table. \r
+  It will ASSERT() if the pointer of System Table is NULL.\r
+  It will ASSERT() if the pointer of Boot 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
 UefiBootServicesTableLibConstructor (\r
index ac4b3eb..bd996ba 100644 (file)
 EFI_RUNTIME_SERVICES  *gRT = NULL;\r
 \r
 /**\r
+  The constructor function caches the pointer of Runtime Services Table.\r
+  \r
+  The constructor function caches the pointer of Runtime Services Table. \r
+  It will ASSERT() if the pointer of Runtime 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
 UefiRuntimeServicesTableLibConstructor (\r