update comments to allign with spec

[mirror_edk2.git] / IntelFrameworkPkg / Include / Protocol / SmmSxDispatch.h

diff --git a/IntelFrameworkPkg/Include/Protocol/SmmSxDispatch.h b/IntelFrameworkPkg/Include/Protocol/SmmSxDispatch.h
index f75bb9c06b1a2c99c36201d998c24677d6be3768..9c3c07743d6a9f4e26f9d426390dcac84dabbe64 100644 (file)
--- a/IntelFrameworkPkg/Include/Protocol/SmmSxDispatch.h
+++ b/IntelFrameworkPkg/Include/Protocol/SmmSxDispatch.h
@@ -70,7 +70,7 @@ typedef struct {
                                 and phases, so the Sx state handler(s) must check the Type and\r
                                 Phase field of EFI_SMM_SX_DISPATCH_CONTEXT and act accordingly.\r
 \r
-  Nothing\r
+  @return None\r
 \r
 **/\r
 typedef\r
@@ -83,9 +83,8 @@ 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  This                  Pointer to the EFI_SMM_SX_DISPATCH_PROTOCOL instance.\r
+  @param  DispatchFunction      Function to install.\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
@@ -112,30 +111,29 @@ VOID
 typedef\r
 EFI_STATUS\r
 (EFIAPI *EFI_SMM_SX_REGISTER)(\r
-  IN EFI_SMM_SX_DISPATCH_PROTOCOL           *This,\r
-  IN  EFI_SMM_SX_DISPATCH                   DispatchFunction,\r
-  IN  EFI_SMM_SX_DISPATCH_CONTEXT           *DispatchContext,\r
-  OUT EFI_HANDLE                            *DispatchHandle\r
+  IN EFI_SMM_SX_DISPATCH_PROTOCOL          *This,\r
+  IN EFI_SMM_SX_DISPATCH                   DispatchFunction,\r
+  IN EFI_SMM_SX_DISPATCH_CONTEXT           *DispatchContext,\r
+  OUT EFI_HANDLE                           *DispatchHandle\r
   );\r
 \r
 /**\r
-  Unregister a child SMI source dispatch function with a parent SMM driver\r
+  Unregisters an Sx-state service\r
 \r
-  @param  This                  Protocol instance pointer.\r
-  @param  DispatchHandle        Handle of dispatch function to deregister.\r
+  @param  This                  Pointer to the EFI_SMM_SX_DISPATCH_PROTOCOL instance.\r
+  @param  DispatchHandle        Handle of the service to remove.\r
 \r
   @retval EFI_SUCCESS           The dispatch function has been successfully unregistered and the\r
                                 SMI source has been disabled if there are no other registered child\r
                                 dispatch functions for this SMI source.\r
   @retval EFI_INVALID_PARAMETER Handle is invalid.\r
-  @retval other                 TBD\r
 \r
 **/\r
 typedef\r
 EFI_STATUS\r
 (EFIAPI *EFI_SMM_SX_UNREGISTER)(\r
-  IN EFI_SMM_SX_DISPATCH_PROTOCOL           *This,\r
-  IN  EFI_HANDLE                            DispatchHandle\r
+  IN EFI_SMM_SX_DISPATCH_PROTOCOL          *This,\r
+  IN EFI_HANDLE                            DispatchHandle\r
   );\r
 \r
 //\r