X-Git-Url: https://git.proxmox.com/?p=mirror_edk2.git;a=blobdiff_plain;f=MdeModulePkg%2FCore%2FDxe%2FDispatcher%2Fdependency.c;h=21f08c2a9c823378d1b49da1a137ad392a6a9c39;hp=62bdb14e406272711824b9098473d0f49fdeb821;hb=162ed594438ab8d39f89b43e6d645ca24e1e1e65;hpb=dc2e539a344115537c1d3883ba96eaade345827b

diff --git a/MdeModulePkg/Core/Dxe/Dispatcher/dependency.c b/MdeModulePkg/Core/Dxe/Dispatcher/dependency.c
index 62bdb14e40..21f08c2a9c 100644
--- a/MdeModulePkg/Core/Dxe/Dispatcher/dependency.c
+++ b/MdeModulePkg/Core/Dxe/Dispatcher/dependency.c
@@ -30,32 +30,20 @@ BOOLEAN *mDepexEvaluationStackPointer = NULL;
 // Worker functions
 //
 
+
+/**
+  Grow size of the Depex stack
+
+  @retval EFI_SUCCESS           Stack successfully growed. 
+  @retval EFI_OUT_OF_RESOURCES  There is not enough system memory to grow the 
+                                stack.
+
+**/
 STATIC
 EFI_STATUS
 GrowDepexStack (
   VOID
   )
-/*++
-
-Routine Description:
-
-  Grow size of the Depex stack
-
-Arguments:
-
-  Stack     - Old stack on the way in and new stack on the way out
-
-  StackSize - New size of the stack
-
-Returns:
-
-  EFI_SUCCESS          - Stack successfully growed.
-  
-  EFI_OUT_OF_RESOURCES - There is not enough system memory to grow the stack.
-  
-  
-
---*/
 {
   BOOLEAN     *NewStack;
   UINTN       Size;
@@ -97,28 +85,22 @@ Returns:
 }
 
 
-STATIC
-EFI_STATUS
-PushBool (
-  IN BOOLEAN  Value
-  )
-/*++
-
-Routine Description:
 
+/**
   Push an element onto the Boolean Stack
 
-Arguments:
-
-  Value - BOOLEAN to push.
+  @param  Value                 BOOLEAN to push. 
 
-Returns:
+  @retval EFI_SUCCESS           The value was pushed onto the stack. 
+  @retval EFI_OUT_OF_RESOURCES  There is not enough system memory to grow the 
+                                stack.
 
-  EFI_SUCCESS          - The value was pushed onto the stack.
-
-  EFI_OUT_OF_RESOURCES - There is not enough system memory to grow the stack.
-
---*/
+**/
+STATIC
+EFI_STATUS
+PushBool (
+  IN BOOLEAN  Value
+  )
 {
   EFI_STATUS  Status;
 
@@ -145,28 +127,21 @@ Returns:
 }
 
 
-STATIC
-EFI_STATUS 
-PopBool (
-  OUT BOOLEAN  *Value
-  )
-/*++
-
-Routine Description:
 
+/**
   Pop an element from the Boolean stack.
 
-Arguments:
-
-  Value - BOOLEAN to pop.
-
-Returns:
+  @param  Value                 BOOLEAN to pop. 
 
-  EFI_SUCCESS       - The value was popped onto the stack.
+  @retval EFI_SUCCESS           The value was popped onto the stack. 
+  @retval EFI_ACCESS_DENIED     The pop operation underflowed the stack
 
-  EFI_ACCESS_DENIED - The pop operation underflowed the stack
-
---*/
+**/
+STATIC
+EFI_STATUS 
+PopBool (
+  OUT BOOLEAN  *Value
+  )
 {
   //
   // Check for a stack underflow condition
@@ -184,29 +159,23 @@ Returns:
 }
 
 
-EFI_STATUS
-CorePreProcessDepex (
-  IN  EFI_CORE_DRIVER_ENTRY   *DriverEntry  
-  )
-/*++
-
-Routine Description:
 
+/**
   Preprocess dependency expression and update DriverEntry to reflect the
   state of  Before, After, and SOR dependencies. If DriverEntry->Before
   or DriverEntry->After is set it will never be cleared. If SOR is set
-  it will be cleared by CoreSchedule(), and then the driver can be 
+  it will be cleared by CoreSchedule(), and then the driver can be
   dispatched.
 
-Arguments:
+  @param  DriverEntry           DriverEntry element to update 
 
-  DriverEntry - DriverEntry element to update
+  @retval EFI_SUCCESS           It always works.
 
-Returns:
-
-  EFI_SUCCESS - It always works.
-
---*/
+**/
+EFI_STATUS
+CorePreProcessDepex (
+  IN  EFI_CORE_DRIVER_ENTRY   *DriverEntry  
+  )
 {
   UINT8  *Iterator;
     
@@ -231,31 +200,24 @@ Returns:
 }
 
 
-BOOLEAN
-CoreIsSchedulable (
-  IN  EFI_CORE_DRIVER_ENTRY   *DriverEntry  
-  )
-/*++
 
-Routine Description:
-
-  This is the POSTFIX version of the dependency evaluator.  This code does 
-  not need to handle Before or After, as it is not valid to call this 
+/**
+  This is the POSTFIX version of the dependency evaluator.  This code does
+  not need to handle Before or After, as it is not valid to call this
   routine in this case. The SOR is just ignored and is a nop in the grammer.
-
   POSTFIX means all the math is done on top of the stack.
 
-Arguments:
+  @param  DriverEntry           DriverEntry element to update 
 
-  DriverEntry - DriverEntry element to update
-  
-Returns:
-
-  TRUE - If driver is ready to run.
-
-  FALSE - If driver is not ready to run or some fatal error was found.
+  @retval TRUE                  If driver is ready to run. 
+  @retval FALSE                 If driver is not ready to run or some fatal error 
+                                was found.
 
---*/
+**/
+BOOLEAN
+CoreIsSchedulable (
+  IN  EFI_CORE_DRIVER_ENTRY   *DriverEntry  
+  )
 {
   EFI_STATUS  Status;
   UINT8       *Iterator;
@@ -444,3 +406,4 @@ Done:
   return FALSE;
 }
 
+