update the file header/function comments of DiskInfo/PciHotPlugRequest protocols...

[mirror_edk2.git] / IntelFrameworkModulePkg / Include / Protocol / PciHotPlugRequest.h

diff --git a/IntelFrameworkModulePkg/Include/Protocol/PciHotPlugRequest.h b/IntelFrameworkModulePkg/Include/Protocol/PciHotPlugRequest.h
index 89cca7be2eced0a0f253289882a4fea1903369de..d4a36aea0e2463862e217e13f2f4abfa2aff8a1c 100644 (file)
--- a/IntelFrameworkModulePkg/Include/Protocol/PciHotPlugRequest.h
+++ b/IntelFrameworkModulePkg/Include/Protocol/PciHotPlugRequest.h
@@ -18,7 +18,9 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #define __PCI_HOTPLUG_REQUEST_H_\r
 \r
 #define EFI_PCI_HOTPLUG_REQUEST_PROTOCOL_GUID \\r
-  {0x19cb87ab,0x2cb9,{0x4665,0x83,0x60,0xdd,0xcf,0x60,0x54,0xf7,0x9d}}\r
+  {\r
+    0x19cb87ab, 0x2cb9, 0x4665, {0x83, 0x60, 0xdd, 0xcf, 0x60, 0x54, 0xf7, 0x9d} \\r
+  }\r
 \r
 typedef enum {\r
   ///\r
@@ -37,26 +39,32 @@ typedef struct _EFI_PCI_HOTPLUG_REQUEST_PROTOCOL  EFI_PCI_HOTPLUG_REQUEST_PROTOC
 \r
 /**\r
   This function allows the PCI bus driver to be notified to act as requested when a hot-plug event has\r
-  happened on the hot-plug controller. Currently, the operations include add operation and remove operation..\r
+  happened on the hot-plug controller. Currently, the operations include add operation and remove operation.\r
   \r
-  @param This                 A pointer to the hot plug request protocol.\r
-  @param Operation            The operation the PCI bus driver is requested to make.\r
-  @param Controller           The handle of the hot-plug controller.\r
-  @param RemainingDevicePath  The remaining device path for the PCI-like hot-plug device.\r
-  @param NumberOfChildren     The number of child handles. \r
-                              For a add operation, it is an output parameter. \r
-                              For a remove operation, it¡¯s an input parameter.\r
-  @param ChildHandleBuffer    The buffer which contains the child handles.\r
+  @param This                    A pointer to the hot plug request protocol.\r
+  @param Operation               The operation the PCI bus driver is requested to make.\r
+  @param Controller              The handle of the hot-plug controller.\r
+  @param RemainingDevicePath     The remaining device path for the PCI-like hot-plug device.\r
+  @param NumberOfChildren        The number of child handles. For a add operation, it is an output parameter. \r
+                                 For a remove operation, it's an input parameter. When it contains a non-zero\r
+                                 value, children handles specified in ChildHandleBuffer are destroyed. Otherwise,\r
+                                 PCI bus driver is notified to stop managing the controller handle.\r
+  @param ChildHandleBuffer       The buffer which contains the child handles. For a add operation, it is an output \r
+                                 parameter and contains all newly created child handles. For a remove operation, it \r
+                                 contains child handles to be destroyed when NumberOfChildren contains a non-\r
+                                 zero value. It can be NULL when NumberOfChildren is 0. It's the caller's \r
+                                 responsibility to allocate and free memory for this buffer.\r
   \r
-  @retval EFI_INVALID_PARAMETER  Operation is not a legal value.\r
-                                 Controller is NULL or not a valid handle.\r
-                                 NumberOfChildren is NULL.\r
-                                 ChildHandleBuffer is NULL while Operation is add.\r
-  @retval EFI_OUT_OF_RESOURCES   There are no enough resources to start the devices.\r
-  @retval EFI_NOT_FOUND          Can not find bridge according to controller handle.\r
   @retval EFI_SUCCESS            The handles for the specified device have been created or destroyed\r
                                  as requested, and for an add operation, the new handles are\r
                                  returned in ChildHandleBuffer.\r
+  @retval EFI_INVALID_PARAMETER  Operation is not a legal value.\r
+  @retval EFI_INVALID_PARAMETER  Controller is NULL or not a valid handle.\r
+  @retval EFI_INVALID_PARAMETER  NumberOfChildren is NULL.\r
+  @retval EFI_INVALID_PARAMETER  ChildHandleBuffer is NULL while Operation is remove and \r
+                                 NumberOfChildren contains a non-zero value.\r
+  @retval EFI_INVALID_PARAMETER  ChildHandleBuffer is NULL while Operation is add.\r
+  @retval EFI_OUT_OF_RESOURCES   There are no enough resources to start the devices.\r
 **/\r
 typedef\r
 EFI_STATUS\r