]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdePkg/Include/Protocol/DriverHealth.h
MdePkg FirmwareManagement.h: Fix typo EFI_SECURITY_VIOLATIO
[mirror_edk2.git] / MdePkg / Include / Protocol / DriverHealth.h
index 24bb5bc1ee5502d3110926d21abafe13d7dcb343..c87c19c1a365303b1f6c9c06996e468b8b383ca4 100644 (file)
@@ -20,7 +20,8 @@
   may then need to be reconnected or the system may need to be rebooted for the \r
   configuration changes to take affect. \r
 \r
-  Copyright (c) 2009, Intel Corporation. All rights reserved.<BR>\r
+  Copyright (c) 2009 - 2013, Intel Corporation. All rights reserved.<BR>\r
+  Copyright (c) 2014, Hewlett-Packard Development Company, L.P.<BR>  \r
   This program and the accompanying materials                          \r
   are licensed and made available under the terms and conditions of the BSD License         \r
   which accompanies this distribution.  The full text of the license may be found at        \r
@@ -30,7 +31,7 @@
   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             \r
 \r
   @par Revision Reference:\r
-  This Protocol is defined in UEFI Specification 2.2 \r
+  This Protocol is defined in UEFI Specification 2.3d \r
 \r
 **/\r
 \r
@@ -62,7 +63,16 @@ typedef enum {
 typedef struct {\r
   EFI_HII_HANDLE  HiiHandle;\r
   EFI_STRING_ID   StringId;\r
-  UINT64          Reserved;\r
+  \r
+  ///\r
+  /// 64-bit numeric value of the warning/error specified by this message. \r
+  ///   A value of 0x0000000000000000 is used to indicate that MessageCode is not specified. \r
+  ///   The values  0x0000000000000001 to 0x0fffffffffffffff are reserved for allocation by the UEFI Specification.\r
+  ///   The values  0x1000000000000000 to 0x1fffffffffffffff are reserved for IHV-developed drivers. \r
+  ///   The values 0x8000000000000000 to 0x8fffffffffffffff is reserved for platform/OEM drivers.\r
+  ///   All other values are reserved and should not be used.\r
+  ///\r
+  UINT64          MessageCode;\r
 } EFI_DRIVER_HEALTH_HII_MESSAGE;\r
 \r
 /**\r
@@ -74,20 +84,10 @@ typedef struct {
   @param[in]  Limit             The maximum value of Value for the current repair operation.\r
                                 For example, a driver that wants to specify progress in \r
                                 percent would use a Limit value of 100.\r
-  \r
-  @retval EFI_SUCCESS           An attempt to repair the controller specified by\r
-                                ControllerHandle and ChildHandle was performed. The\r
-                                result of the repair operation can bet determined by\r
-                                calling GetHealthStatus().\r
-  @retval EFI_UNSUPPORTED       The driver specified by This is not currently managing the\r
-                                controller specified by ControllerHandle and\r
-                                ChildHandle.\r
-  @retval EFI_OUT_OF_RESOURCES  There are not enough resources to perform the repair operation.\r
-\r
 **/\r
 typedef\r
 EFI_STATUS\r
-(EFIAPI *EFI_DRIVER_HEALTH_REPAIR_PROGRESS_NOTIFY)(\r
+(EFIAPI *EFI_DRIVER_HEALTH_REPAIR_NOTIFY)(\r
   IN UINTN  Value,\r
   IN UINTN  Limit\r
   );\r
@@ -131,7 +131,7 @@ EFI_STATUS
                               containing a EFI_HII_HANDLE with a value of NULL.  The \r
                               EFI_HII_STRING_PROTOCOL.GetString() function can be used to \r
                               retrieve the warning or error message as a Null-terminated \r
-                              Unicode string in a specific language.  Messages may be \r
+                              string in a specific language.  Messages may be \r
                               returned for any of the HealthStatus values except \r
                               EfiDriverHealthStatusReconnectRequired and \r
                               EfiDriverHealthStatusRebootRequired.\r
@@ -193,17 +193,17 @@ EFI_STATUS
   Performs a repair operation on a controller in the platform.  This function can \r
   optionally report repair progress information back to the platform. \r
   \r
-  @param[in] This                  A pointer to the EFI_DRIVER_HEALTH_PROTOCOL instance.\r
-  @param[in] ControllerHandle      The handle of the controller to repair.\r
-  @param[in] ChildHandle           The handle of the child controller to repair.  This is \r
-                                   an optional parameter that may be NULL.  It will be NULL \r
-                                   for device drivers.  It will also be NULL for bus \r
-                                   drivers when an attempt is made to repair a bus controller.\r
-                                   If will not be NULL when an attempt is made to repair a \r
-                                   child controller produced by the driver.\r
-  @param[in] ProgressNotification  A notification function that may be used by a driver to \r
-                                   report the progress of the repair operation.  This is \r
-                                   an optional parameter that may be NULL.  \r
+  @param[in] This              A pointer to the EFI_DRIVER_HEALTH_PROTOCOL instance.\r
+  @param[in] ControllerHandle  The handle of the controller to repair.\r
+  @param[in] ChildHandle       The handle of the child controller to repair.  This is \r
+                               an optional parameter that may be NULL.  It will be NULL \r
+                               for device drivers.  It will also be NULL for bus \r
+                               drivers when an attempt is made to repair a bus controller.\r
+                               If will not be NULL when an attempt is made to repair a \r
+                               child controller produced by the driver.\r
+  @param[in] RepairNotify      A notification function that may be used by a driver to \r
+                               report the progress of the repair operation.  This is \r
+                               an optional parameter that may be NULL.  \r
 \r
 \r
   @retval EFI_SUCCESS           An attempt to repair the controller specified by \r
@@ -222,8 +222,8 @@ EFI_STATUS
 (EFIAPI *EFI_DRIVER_HEALTH_REPAIR)(\r
   IN  EFI_DRIVER_HEALTH_PROTOCOL                *This,\r
   IN  EFI_HANDLE                                ControllerHandle,\r
-  IN  EFI_HANDLE                                ChildHandle          OPTIONAL,\r
-  IN  EFI_DRIVER_HEALTH_REPAIR_PROGRESS_NOTIFY  ProgressNotification OPTIONAL\r
+  IN  EFI_HANDLE                                ChildHandle       OPTIONAL,\r
+  IN  EFI_DRIVER_HEALTH_REPAIR_NOTIFY           RepairNotify      OPTIONAL\r
   );\r
 \r
 ///\r