Coding style modification.

[mirror_edk2.git] / IntelFrameworkModulePkg / Bus / Pci / PciBusDxe / PciEnumeratorSupport.c

diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.c b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.c
index 0a5292e7967885a47fb375565324623c5c606c8b..2aa85c585679d6ffe7ec98c28a7dad9340200041 100644 (file)
--- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.c
+++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.c
@@ -25,7 +25,7 @@ PciDevicePresent (
   UINT8                               Device,\r
   UINT8                               Func\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -37,7 +37,7 @@ Returns:
 \r
   None\r
 \r
---*/\r
+**/\r
 // TODO:    PciRootBridgeIo - add argument and description to function comment\r
 // TODO:    Pci - add argument and description to function comment\r
 // TODO:    Bus - add argument and description to function comment\r
@@ -92,7 +92,7 @@ PciPciDeviceInfoCollector (
   IN PCI_IO_DEVICE                      *Bridge,\r
   UINT8                                 StartBusNumber\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -102,7 +102,7 @@ Returns:
 \r
   None\r
 \r
---*/\r
+**/\r
 // TODO:    Bridge - add argument and description to function comment\r
 // TODO:    StartBusNumber - add argument and description to function comment\r
 // TODO:    EFI_SUCCESS - add return value to function comment\r
@@ -210,7 +210,7 @@ PciSearchDevice (
   IN  UINT8                                 Func,\r
   OUT PCI_IO_DEVICE                         **PciDevice\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -229,7 +229,7 @@ Returns:
 \r
   Status code.\r
 \r
---*/\r
+**/\r
 // TODO:    EFI_OUT_OF_RESOURCES - add return value to function comment\r
 // TODO:    EFI_OUT_OF_RESOURCES - add return value to function comment\r
 // TODO:    EFI_SUCCESS - add return value to function comment\r
@@ -339,7 +339,7 @@ GatherDeviceInfo (
   UINT8                               Device,\r
   UINT8                               Func\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -349,7 +349,7 @@ Returns:
 \r
   None\r
 \r
---*/\r
+**/\r
 // TODO:    Bridge - add argument and description to function comment\r
 // TODO:    Pci - add argument and description to function comment\r
 // TODO:    Bus - add argument and description to function comment\r
@@ -409,7 +409,7 @@ GatherPpbInfo (
   UINT8                               Device,\r
   UINT8                               Func\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -419,7 +419,7 @@ Returns:
 \r
   None\r
 \r
---*/\r
+**/\r
 // TODO:    Bridge - add argument and description to function comment\r
 // TODO:    Pci - add argument and description to function comment\r
 // TODO:    Bus - add argument and description to function comment\r
@@ -543,7 +543,7 @@ GatherP2CInfo (
   UINT8                               Device,\r
   UINT8                               Func\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -553,7 +553,7 @@ Returns:
 \r
   None\r
 \r
---*/\r
+**/\r
 // TODO:    Bridge - add argument and description to function comment\r
 // TODO:    Pci - add argument and description to function comment\r
 // TODO:    Bus - add argument and description to function comment\r
@@ -614,7 +614,7 @@ CreatePciDevicePath (
   IN  EFI_DEVICE_PATH_PROTOCOL *ParentDevicePath,\r
   IN  PCI_IO_DEVICE            *PciIoDevice\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -624,7 +624,7 @@ Returns:
 \r
   None\r
 \r
---*/\r
+**/\r
 // TODO:    ParentDevicePath - add argument and description to function comment\r
 // TODO:    PciIoDevice - add argument and description to function comment\r
 {\r
@@ -652,7 +652,7 @@ BarExisted (
   OUT UINT32       *BarLengthValue,\r
   OUT UINT32       *OriginalBarValue\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -670,7 +670,7 @@ Returns:
   EFI_NOT_FOUND     - The bar don't exist.\r
   EFI_SUCCESS       - The bar exist.\r
 \r
---*/\r
+**/\r
 {\r
   EFI_PCI_IO_PROTOCOL *PciIo;\r
   UINT32              OriginalValue;\r
@@ -726,7 +726,7 @@ PciTestSupportedAttribute (
   IN UINT16                             *OldCommand,\r
   IN UINT16                             *OldBridgeControl\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -736,7 +736,7 @@ Returns:
 \r
   None\r
 \r
---*/\r
+**/\r
 // TODO:    PciIoDevice - add argument and description to function comment\r
 // TODO:    Command - add argument and description to function comment\r
 // TODO:    BridgeControl - add argument and description to function comment\r
@@ -809,7 +809,7 @@ PciSetDeviceAttribute (
   IN UINT16                             BridgeControl,\r
   IN UINTN                              Option\r
   )\r
-/*++\r
+/**\r
 \r
   Routine Description:\r
     Set the supported or current attributes of a PCI device\r
@@ -822,9 +822,9 @@ PciSetDeviceAttribute (
 \r
   Returns:\r
 \r
---*/\r
+**/\r
 \r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -838,7 +838,7 @@ Returns:
   EFI_SUCCESS   Always success\r
 \r
 \r
---*/\r
+**/\r
 {\r
   UINT64  Attributes;\r
 \r
@@ -925,7 +925,7 @@ GetFastBackToBackSupport (
   IN PCI_IO_DEVICE                      *PciIoDevice,\r
   IN UINT8                              StatusIndex\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -937,7 +937,7 @@ Returns:
 \r
   None\r
 \r
---*/\r
+**/\r
 // TODO:    PciIoDevice - add argument and description to function comment\r
 // TODO:    StatusIndex - add argument and description to function comment\r
 // TODO:    EFI_UNSUPPORTED - add return value to function comment\r
@@ -973,7 +973,7 @@ EFI_STATUS
 ProcessOptionRomLight (\r
   IN PCI_IO_DEVICE                      *PciIoDevice\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -986,7 +986,7 @@ Returns:
 \r
   None\r
 \r
---*/\r
+**/\r
 // TODO:    PciIoDevice - add argument and description to function comment\r
 // TODO:    EFI_SUCCESS - add return value to function comment\r
 {\r
@@ -1022,7 +1022,7 @@ EFI_STATUS
 DetermineDeviceAttribute (\r
   IN PCI_IO_DEVICE                      *PciIoDevice\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -1034,7 +1034,7 @@ Returns:
 \r
   None\r
 \r
---*/\r
+**/\r
 // TODO:    PciIoDevice - add argument and description to function comment\r
 // TODO:    EFI_SUCCESS - add return value to function comment\r
 {\r
@@ -1201,7 +1201,7 @@ EFI_STATUS
 UpdatePciInfo (\r
   IN PCI_IO_DEVICE  *PciIoDevice\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -1213,7 +1213,7 @@ Returns:
 \r
   None\r
 \r
---*/\r
+**/\r
 // TODO:    PciIoDevice - add argument and description to function comment\r
 // TODO:    EFI_UNSUPPORTED - add return value to function comment\r
 {\r
@@ -1359,7 +1359,7 @@ SetNewAlign (
   IN UINT64 *Alignment,\r
   IN UINT64 NewAlignment\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -1371,7 +1371,7 @@ Returns:
 \r
   None\r
 \r
---*/\r
+**/\r
 // TODO:    Alignment - add argument and description to function comment\r
 // TODO:    NewAlignment - add argument and description to function comment\r
 {\r
@@ -1438,7 +1438,7 @@ PciParseBar (
   IN UINTN          Offset,\r
   IN UINTN          BarIndex\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -1448,7 +1448,7 @@ Returns:
 \r
   None\r
 \r
---*/\r
+**/\r
 // TODO:    PciIoDevice - add argument and description to function comment\r
 // TODO:    Offset - add argument and description to function comment\r
 // TODO:    BarIndex - add argument and description to function comment\r
@@ -1628,7 +1628,7 @@ EFI_STATUS
 InitializePciDevice (\r
   IN PCI_IO_DEVICE *PciIoDevice\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -1641,7 +1641,7 @@ Returns:
 \r
   None\r
 \r
---*/\r
+**/\r
 // TODO:    PciIoDevice - add argument and description to function comment\r
 // TODO:    EFI_SUCCESS - add return value to function comment\r
 {\r
@@ -1666,7 +1666,7 @@ EFI_STATUS
 InitializePpb (\r
   IN PCI_IO_DEVICE *PciIoDevice\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -1676,7 +1676,7 @@ Returns:
 \r
   None\r
 \r
---*/\r
+**/\r
 // TODO:    PciIoDevice - add argument and description to function comment\r
 // TODO:    EFI_SUCCESS - add return value to function comment\r
 {\r
@@ -1719,7 +1719,7 @@ EFI_STATUS
 InitializeP2C (\r
   IN PCI_IO_DEVICE *PciIoDevice\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -1729,7 +1729,7 @@ Returns:
 \r
   None\r
 \r
---*/\r
+**/\r
 // TODO:    PciIoDevice - add argument and description to function comment\r
 // TODO:    EFI_SUCCESS - add return value to function comment\r
 {\r
@@ -1769,7 +1769,7 @@ CreatePciIoDevice (
   UINT8                               Device,\r
   UINT8                               Func\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -1779,7 +1779,7 @@ Returns:
 \r
   None\r
 \r
---*/\r
+**/\r
 // TODO:    PciRootBridgeIo - add argument and description to function comment\r
 // TODO:    Pci - add argument and description to function comment\r
 // TODO:    Bus - add argument and description to function comment\r
@@ -1862,7 +1862,7 @@ EFI_STATUS
 PciEnumeratorLight (\r
   IN EFI_HANDLE                    Controller\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -1876,7 +1876,7 @@ Returns:
 \r
   None\r
 \r
---*/\r
+**/\r
 // TODO:    Controller - add argument and description to function comment\r
 // TODO:    EFI_SUCCESS - add return value to function comment\r
 // TODO:    EFI_SUCCESS - add return value to function comment\r
@@ -1985,7 +1985,7 @@ PciGetBusRange (
   OUT    UINT16                             *MaxBus,\r
   OUT    UINT16                             *BusRange\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -2002,7 +2002,7 @@ Returns:
 \r
   Status Code.\r
 \r
---*/\r
+**/\r
 // TODO:    EFI_SUCCESS - add return value to function comment\r
 // TODO:    EFI_NOT_FOUND - add return value to function comment\r
 {\r
@@ -2034,7 +2034,7 @@ EFI_STATUS
 StartManagingRootBridge (\r
   IN PCI_IO_DEVICE *RootBridgeDev\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -2045,7 +2045,7 @@ Returns:
 \r
   None\r
 \r
---*/\r
+**/\r
 // TODO:    RootBridgeDev - add argument and description to function comment\r
 // TODO:    EFI_SUCCESS - add return value to function comment\r
 {\r
@@ -2088,7 +2088,7 @@ BOOLEAN
 IsPciDeviceRejected (\r
   IN PCI_IO_DEVICE *PciIoDevice\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -2101,7 +2101,7 @@ Returns:
   TRUE      This device should be rejected\r
   FALSE     This device shouldn't be rejected\r
 \r
---*/\r
+**/\r
 // TODO:    PciIoDevice - add argument and description to function comment\r
 {\r
   EFI_STATUS  Status;\r
@@ -2209,7 +2209,7 @@ ResetAllPpbBusNumber (
   IN PCI_IO_DEVICE                      *Bridge,\r
   IN UINT8                              StartBusNumber\r
   )\r
-/*++\r
+/**\r
 \r
 Routine Description:\r
 \r
@@ -2224,7 +2224,7 @@ Returns:
 \r
   EFI_SUCCESS - TODO: Add description for return value\r
 \r
---*/\r
+**/\r
 {\r
   EFI_STATUS                      Status;\r
   PCI_TYPE00                      Pci;\r