From 91d92e25647e9a26392b454499d309330710a076 Mon Sep 17 00:00:00 2001
From: qhuang8 <qhuang8@6f19259b-4bc3-4df7-8a09-765794883524>
Date: Wed, 7 May 2008 06:58:06 +0000
Subject: Add doxygen style comments for functions in DxeIpl.

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@5174 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Core/DxeIplPeim/Ia32/ImageRead.c | 66 +++++++++++++--------------
 1 file changed, 31 insertions(+), 35 deletions(-)

(limited to 'MdeModulePkg/Core/DxeIplPeim/Ia32/ImageRead.c')

diff --git a/MdeModulePkg/Core/DxeIplPeim/Ia32/ImageRead.c b/MdeModulePkg/Core/DxeIplPeim/Ia32/ImageRead.c
index b6278154d1..1a5135c4dc 100644
--- a/MdeModulePkg/Core/DxeIplPeim/Ia32/ImageRead.c
+++ b/MdeModulePkg/Core/DxeIplPeim/Ia32/ImageRead.c
@@ -14,6 +14,23 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 #include "DxeIpl.h"
 
+
+
+
+
+/**
+  Support routine for the PE/COFF Loader that reads a buffer from a PE/COFF file
+
+  @param  FileHandle   The handle to the PE/COFF file 
+  @param  FileOffset   The offset, in bytes, into the file to read 
+  @param  ReadSize     The number of bytes to read from the file starting at 
+                       FileOffset 
+  @param  Buffer       A pointer to the buffer to read the data into. 
+
+  @retval EFI_SUCCESS  ReadSize bytes of data were read into Buffer from the 
+                       PE/COFF file starting at FileOffset
+
+**/
 EFI_STATUS
 EFIAPI
 PeiImageRead (
@@ -22,27 +39,6 @@ PeiImageRead (
   IN OUT UINTN   *ReadSize,
   OUT    VOID    *Buffer
   )
-/*++
-
-Routine Description:
-
-  Support routine for the PE/COFF Loader that reads a buffer from a PE/COFF file
-
-Arguments:
-
-  FileHandle - The handle to the PE/COFF file
-
-  FileOffset - The offset, in bytes, into the file to read
-
-  ReadSize   - The number of bytes to read from the file starting at FileOffset
-
-  Buffer     - A pointer to the buffer to read the data into.
-
-Returns:
-
-  EFI_SUCCESS - ReadSize bytes of data were read into Buffer from the PE/COFF file starting at FileOffset
-
---*/
 {
   UINT8 *Destination32;
   UINT8 *Source32;
@@ -66,24 +62,24 @@ Returns:
   return EFI_SUCCESS;
 }
 
-EFI_STATUS
-GetImageReadFunction (
-  IN      PE_COFF_LOADER_IMAGE_CONTEXT  *ImageContext
-  )
-/*++
 
-Routine Description:
-  Support routine to return the PE32 Image Reader.
-  If the PeiImageRead() function is less than a page
-  in legnth. If the function is more than a page the DXE IPL will crash!!!!
 
-Arguments:
-  ImageContext  - The context of the image being loaded
 
-Returns:
-  EFI_SUCCESS - If Image function location is found
 
---*/
+/**
+   This function simply retrieves the function pointer of ImageRead in
+   ImageContext structure.
+    
+   @param ImageContext       A pointer to the structure of 
+                             PE_COFF_LOADER_IMAGE_CONTEXT
+   
+   @retval EFI_SUCCESS       This function always return EFI_SUCCESS.
+
+**/
+EFI_STATUS
+GetImageReadFunction (
+  IN      PE_COFF_LOADER_IMAGE_CONTEXT  *ImageContext
+  )
 {
   VOID        *MemoryBuffer;
 
-- 
cgit v1.2.3