Remove BugBug in comments and adjust function header according to code style doc.

[mirror_edk2.git] / MdePkg / Include / Protocol / SmmPowerButtonDispatch.h

diff --git a/MdePkg/Include/Protocol/SmmPowerButtonDispatch.h b/MdePkg/Include/Protocol/SmmPowerButtonDispatch.h
index 065d85f09e127c37bae11dfce322022f0dc2fe8d..891a1fd2b3073136950fbbbed4ac24447c91c7f4 100644 (file)
--- a/MdePkg/Include/Protocol/SmmPowerButtonDispatch.h
+++ b/MdePkg/Include/Protocol/SmmPowerButtonDispatch.h
@@ -54,11 +54,11 @@ typedef struct {
 /**\r
   Dispatch function for a Power Button SMI handler.\r
 \r
-  @param  DispatchHandle Handle of this dispatch function.\r
-  @param  DispatchContext Pointer to the dispatch function's context.\r
-  The DispatchContext fields are filled in\r
-  by the dispatching driver prior to\r
-  invoking this dispatch function.\r
+  @param  DispatchHandle        Handle of this dispatch function.\r
+  @param  DispatchContext       Pointer to the dispatch function's context.\r
+                                The DispatchContext fields are filled in\r
+                                by the dispatching driver prior to\r
+                                invoking this dispatch function.\r
 \r
   Nothing\r
 \r
@@ -73,24 +73,24 @@ VOID
 /**\r
   Register a child SMI source dispatch function with a parent SMM driver\r
 \r
-  @param  This Protocol instance pointer.\r
-  @param  DispatchFunction Pointer to dispatch function to be invoked for\r
-  this SMI source\r
-  @param  DispatchContext Pointer to the dispatch function's context.\r
-  The caller fills this context in before calling\r
-  the register function to indicate to the register\r
-  function the Power Button SMI phase for which the dispatch\r
-  function should be invoked.\r
-  @param  DispatchHandle Handle of dispatch function, for when interfacing\r
-  with the parent Sx state SMM driver.\r
-\r
-  @retval  EFI_SUCCESS The dispatch function has been successfully\r
-  registered and the SMI source has been enabled.\r
-  @retval  EFI_DEVICE_ERROR The driver was unable to enable the SMI source.\r
-  @retval  EFI_OUT_OF_RESOURCES Not enough memory (system or SMM) to manage this\r
-  child.\r
-  @retval  EFI_INVALID_PARAMETER DispatchContext is invalid. The Power Button  SMI\r
-  phase is not within valid range.\r
+  @param  This                  Protocol instance pointer.\r
+  @param  DispatchFunction      Pointer to dispatch function to be invoked for\r
+                                this SMI source\r
+  @param  DispatchContext       Pointer to the dispatch function's context.\r
+                                The caller fills this context in before calling\r
+                                the register function to indicate to the register\r
+                                function the Power Button SMI phase for which the dispatch\r
+                                function should be invoked.\r
+  @param  DispatchHandle        Handle of dispatch function, for when interfacing\r
+                                with the parent Sx state SMM driver.\r
+\r
+  @retval EFI_SUCCESS           The dispatch function has been successfully\r
+                                registered and the SMI source has been enabled.\r
+  @retval EFI_DEVICE_ERROR      The driver was unable to enable the SMI source.\r
+  @retval EFI_OUT_OF_RESOURCES  Not enough memory (system or SMM) to manage this\r
+                                child.\r
+  @retval EFI_INVALID_PARAMETER DispatchContext is invalid. The Power Button SMI\r
+                                phase is not within valid range.\r
 \r
 **/\r
 typedef\r
@@ -105,15 +105,15 @@ EFI_STATUS
 /**\r
   Unregister a child SMI source dispatch function with a parent SMM driver\r
 \r
-  @param  This Protocol instance pointer.\r
-  @param  DispatchHandle Handle of dispatch function to deregister.\r
+  @param  This                  Protocol instance pointer.\r
+  @param  DispatchHandle        Handle of dispatch function to deregister.\r
 \r
-  @retval  EFI_SUCCESS The dispatch function has been successfully\r
-  unregistered and the SMI source has been disabled\r
-  if there are no other registered child dispatch\r
-  functions for this SMI source.\r
-  @retval  EFI_INVALID_PARAMETER Handle is invalid.\r
-  @retval  other TBD\r
+  @retval EFI_SUCCESS           The dispatch function has been successfully\r
+                                unregistered and the SMI source has been disabled\r
+                                if there are no other registered child dispatch\r
+                                functions for this SMI source.\r
+  @retval EFI_INVALID_PARAMETER Handle is invalid.\r
+  @retval other                 TBD\r
 \r
 **/\r
 typedef\r