Fix PeiLoadImage() for compressed peim to print the correct image address and entrypoint.

[mirror_edk2.git] / EdkModulePkg / Bus / Pci / IdeBus / Dxe / ide.h

diff --git a/EdkModulePkg/Bus/Pci/IdeBus/Dxe/ide.h b/EdkModulePkg/Bus/Pci/IdeBus/Dxe/ide.h
index 4c43ab94cd6c85424f5f070976a9ae3ec3c82e32..177e842714b6f24b196818aec97c7dd0481d5b96 100644 (file)
--- a/EdkModulePkg/Bus/Pci/IdeBus/Dxe/ide.h
+++ b/EdkModulePkg/Bus/Pci/IdeBus/Dxe/ide.h
@@ -1,62 +1,58 @@
-/*++\r
-Copyright (c) 2006, Intel Corporation                                                         \r
-All rights reserved. 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
-http://opensource.org/licenses/bsd-license.php                                            \r
-                                                                                          \r
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     \r
-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             \r
+/** @file\r
+  Header file for IDE Bus Driver, containing the helper functions' \r
+  entire prototype.\r
 \r
-Module Name:\r
+  Copyright (c) 2006, Intel Corporation                                                         \r
+  All rights reserved. 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
+  http://opensource.org/licenses/bsd-license.php                                            \r
 \r
-    ide.h\r
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     \r
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             \r
 \r
-Abstract:\r
+  @par Revision Reference:\r
+  2002-6: Add Atapi6 enhancement, support >120GB hard disk, including\r
+  Add - IDEBlkIoReadBlocksExt() func definition\r
+  Add - IDEBlkIoWriteBlocksExt() func definition\r
 \r
-    Header file for IDE Bus Driver, containing the helper functions' \r
-    entire prototype.\r
+**/\r
 \r
-Revision History\r
-\r
-    2002-6: Add Atapi6 enhancement, support >120GB hard disk, including\r
-            Add - IDEBlkIoReadBlocksExt() func definition\r
-            Add - IDEBlkIoWriteBlocksExt() func definition\r
-            \r
-++*/\r
-\r
-// TODO: fix comment to end with --*/\r
 #ifndef _IDE_H\r
 #define _IDE_H\r
 \r
 //\r
 // Helper functions Prototype\r
 //\r
+/**\r
+  TODO: Add function description\r
+\r
+  @param  This TODO: add argument description\r
+  @param  Controller TODO: add argument description\r
+  @param  Handle TODO: add argument description\r
+\r
+  TODO: add return values\r
+\r
+**/\r
 EFI_STATUS\r
 DeRegisterIdeDevice (\r
   IN  EFI_DRIVER_BINDING_PROTOCOL    *This,\r
   IN  EFI_HANDLE                     Controller,\r
   IN  EFI_HANDLE                     Handle\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  This        - TODO: add argument description\r
-  Controller  - TODO: add argument description\r
-  Handle      - TODO: add argument description\r
-\r
-Returns:\r
+  @param  Controller TODO: add argument description\r
+  @param  PciIo TODO: add argument description\r
+  @param  ParentDevicePath TODO: add argument description\r
+  @param  RemainingDevicePath TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 EnableIdeDevice (\r
   IN EFI_HANDLE                          Controller,\r
@@ -64,49 +60,35 @@ EnableIdeDevice (
   IN EFI_DEVICE_PATH_PROTOCOL            *ParentDevicePath,\r
   IN EFI_DEVICE_PATH_PROTOCOL            *RemainingDevicePath\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  Controller          - TODO: add argument description\r
-  PciIo               - TODO: add argument description\r
-  ParentDevicePath    - TODO: add argument description\r
-  RemainingDevicePath - TODO: add argument description\r
-\r
-Returns:\r
+  @param  PciIo TODO: add argument description\r
+  @param  Port TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 UINT8\r
 IDEReadPortB (\r
   IN  EFI_PCI_IO_PROTOCOL   *PciIo,\r
   IN  UINT16                Port\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  PciIo - TODO: add argument description\r
-  Port  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  PciIo TODO: add argument description\r
+  @param  Port TODO: add argument description\r
+  @param  Count TODO: add argument description\r
+  @param  Buffer TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 VOID\r
 IDEReadPortWMultiple (\r
   IN  EFI_PCI_IO_PROTOCOL   *PciIo,\r
@@ -114,76 +96,55 @@ IDEReadPortWMultiple (
   IN  UINTN                 Count,\r
   OUT  VOID                 *Buffer\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  PciIo   - TODO: add argument description\r
-  Port    - TODO: add argument description\r
-  Count   - TODO: add argument description\r
-  Buffer  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  PciIo TODO: add argument description\r
+  @param  Port TODO: add argument description\r
+  @param  Data TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 VOID\r
 IDEWritePortB (\r
   IN  EFI_PCI_IO_PROTOCOL   *PciIo,\r
   IN  UINT16                Port,\r
   IN  UINT8                 Data\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  PciIo - TODO: add argument description\r
-  Port  - TODO: add argument description\r
-  Data  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  PciIo TODO: add argument description\r
+  @param  Port TODO: add argument description\r
+  @param  Data TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 VOID\r
 IDEWritePortW (\r
   IN  EFI_PCI_IO_PROTOCOL   *PciIo,\r
   IN  UINT16                Port,\r
   IN  UINT16                Data\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  PciIo - TODO: add argument description\r
-  Port  - TODO: add argument description\r
-  Data  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  PciIo TODO: add argument description\r
+  @param  Port TODO: add argument description\r
+  @param  Count TODO: add argument description\r
+  @param  Buffer TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 VOID\r
 IDEWritePortWMultiple (\r
   IN  EFI_PCI_IO_PROTOCOL   *PciIo,\r
@@ -191,366 +152,259 @@ IDEWritePortWMultiple (
   IN  UINTN                 Count,\r
   IN  VOID                  *Buffer\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  PciIo   - TODO: add argument description\r
-  Port    - TODO: add argument description\r
-  Count   - TODO: add argument description\r
-  Buffer  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  PciIo TODO: add argument description\r
+  @param  IdeRegsBaseAddr TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 GetIdeRegistersBaseAddr (\r
   IN  EFI_PCI_IO_PROTOCOL         *PciIo,\r
   OUT IDE_REGISTERS_BASE_ADDR     *IdeRegsBaseAddr\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  PciIo           - TODO: add argument description\r
-  IdeRegsBaseAddr - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 ReassignIdeResources (\r
   IN  IDE_BLK_IO_DEV  *IdeDev\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 DiscoverIdeDevice (\r
   IN IDE_BLK_IO_DEV *IdeDev\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 DetectIDEController (\r
   IN  IDE_BLK_IO_DEV  *IdeDev\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  TimeoutInMilliSeconds TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 DRQClear (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
   IN  UINTN           TimeoutInMilliSeconds\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev                - TODO: add argument description\r
-  TimeoutInMilliSeconds - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  TimeoutInMilliSeconds TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 DRQClear2 (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
   IN  UINTN           TimeoutInMilliSeconds\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev                - TODO: add argument description\r
-  TimeoutInMilliSeconds - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  TimeoutInMilliSeconds TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 DRQReady (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
   IN  UINTN           TimeoutInMilliSeconds\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev                - TODO: add argument description\r
-  TimeoutInMilliSeconds - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  TimeoutInMilliSeconds TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 DRQReady2 (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
   IN  UINTN           TimeoutInMilliSeconds\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev                - TODO: add argument description\r
-  TimeoutInMilliSeconds - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  TimeoutInMilliSeconds TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 WaitForBSYClear (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
   IN  UINTN           TimeoutInMilliSeconds\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev                - TODO: add argument description\r
-  TimeoutInMilliSeconds - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  TimeoutInMilliSeconds TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 WaitForBSYClear2 (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
   IN  UINTN           TimeoutInMilliSeconds\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev                - TODO: add argument description\r
-  TimeoutInMilliSeconds - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  DelayInMilliSeconds TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 DRDYReady (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
   IN  UINTN           DelayInMilliSeconds\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev              - TODO: add argument description\r
-  DelayInMilliSeconds - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  DelayInMilliSeconds TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 DRDYReady2 (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
   IN  UINTN           DelayInMilliSeconds\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev              - TODO: add argument description\r
-  DelayInMilliSeconds - TODO: add argument description\r
-\r
-Returns:\r
+  @param  Destination TODO: add argument description\r
+  @param  Source TODO: add argument description\r
+  @param  Size TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 VOID\r
 SwapStringChars (\r
   IN CHAR8  *Destination,\r
   IN CHAR8  *Source,\r
   IN UINT32 Size\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+//\r
+//  ATA device functions' prototype\r
+//\r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  Destination - TODO: add argument description\r
-  Source      - TODO: add argument description\r
-  Size        - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
-//\r
-//  ATA device functions' prototype\r
-//\r
+**/\r
 EFI_STATUS\r
 ATAIdentify (\r
   IN  IDE_BLK_IO_DEV  *IdeDev\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 VOID\r
 PrintAtaModuleName (\r
   IN  IDE_BLK_IO_DEV  *IdeDev\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  Buffer TODO: add argument description\r
+  @param  ByteCount TODO: add argument description\r
+  @param  AtaCommand TODO: add argument description\r
+  @param  Head TODO: add argument description\r
+  @param  SectorCount TODO: add argument description\r
+  @param  SectorNumber TODO: add argument description\r
+  @param  CylinderLsb TODO: add argument description\r
+  @param  CylinderMsb TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtaPioDataIn (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
@@ -563,31 +417,24 @@ AtaPioDataIn (
   IN  UINT8           CylinderLsb,\r
   IN  UINT8           CylinderMsb\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev        - TODO: add argument description\r
-  Buffer        - TODO: add argument description\r
-  ByteCount     - TODO: add argument description\r
-  AtaCommand    - TODO: add argument description\r
-  Head          - TODO: add argument description\r
-  SectorCount   - TODO: add argument description\r
-  SectorNumber  - TODO: add argument description\r
-  CylinderLsb   - TODO: add argument description\r
-  CylinderMsb   - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  Buffer TODO: add argument description\r
+  @param  ByteCount TODO: add argument description\r
+  @param  AtaCommand TODO: add argument description\r
+  @param  Head TODO: add argument description\r
+  @param  SectorCount TODO: add argument description\r
+  @param  SectorNumber TODO: add argument description\r
+  @param  CylinderLsb TODO: add argument description\r
+  @param  CylinderMsb TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtaPioDataOut (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
@@ -600,52 +447,33 @@ AtaPioDataOut (
   IN  UINT8           CylinderLsb,\r
   IN  UINT8           CylinderMsb\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev        - TODO: add argument description\r
-  Buffer        - TODO: add argument description\r
-  ByteCount     - TODO: add argument description\r
-  AtaCommand    - TODO: add argument description\r
-  Head          - TODO: add argument description\r
-  SectorCount   - TODO: add argument description\r
-  SectorNumber  - TODO: add argument description\r
-  CylinderLsb   - TODO: add argument description\r
-  CylinderMsb   - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 CheckErrorStatus (\r
   IN  IDE_BLK_IO_DEV  *IdeDev\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  DataBuffer TODO: add argument description\r
+  @param  Lba TODO: add argument description\r
+  @param  NumberOfBlocks TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtaReadSectors (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
@@ -653,26 +481,19 @@ AtaReadSectors (
   IN  EFI_LBA         Lba,\r
   IN  UINTN           NumberOfBlocks\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev          - TODO: add argument description\r
-  DataBuffer      - TODO: add argument description\r
-  Lba             - TODO: add argument description\r
-  NumberOfBlocks  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  BufferData TODO: add argument description\r
+  @param  Lba TODO: add argument description\r
+  @param  NumberOfBlocks TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtaWriteSectors (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
@@ -680,47 +501,34 @@ AtaWriteSectors (
   IN  EFI_LBA         Lba,\r
   IN  UINTN           NumberOfBlocks\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev          - TODO: add argument description\r
-  BufferData      - TODO: add argument description\r
-  Lba             - TODO: add argument description\r
-  NumberOfBlocks  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtaSoftReset (\r
   IN  IDE_BLK_IO_DEV  *IdeDev\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeBlkIoDevice TODO: add argument description\r
+  @param  MediaId TODO: add argument description\r
+  @param  LBA TODO: add argument description\r
+  @param  BufferSize TODO: add argument description\r
+  @param  Buffer TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtaBlkIoReadBlocks (\r
   IN IDE_BLK_IO_DEV   *IdeBlkIoDevice,\r
@@ -729,27 +537,20 @@ AtaBlkIoReadBlocks (
   IN UINTN            BufferSize,\r
   OUT VOID            *Buffer\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeBlkIoDevice  - TODO: add argument description\r
-  MediaId         - TODO: add argument description\r
-  LBA             - TODO: add argument description\r
-  BufferSize      - TODO: add argument description\r
-  Buffer          - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeBlkIoDevice TODO: add argument description\r
+  @param  MediaId TODO: add argument description\r
+  @param  LBA TODO: add argument description\r
+  @param  BufferSize TODO: add argument description\r
+  @param  Buffer TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtaBlkIoWriteBlocks (\r
   IN IDE_BLK_IO_DEV   *IdeBlkIoDevice,\r
@@ -758,72 +559,51 @@ AtaBlkIoWriteBlocks (
   IN UINTN            BufferSize,\r
   OUT VOID            *Buffer\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+//\r
+// ATAPI device functions' prototype\r
+//\r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeBlkIoDevice  - TODO: add argument description\r
-  MediaId         - TODO: add argument description\r
-  LBA             - TODO: add argument description\r
-  BufferSize      - TODO: add argument description\r
-  Buffer          - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
-//\r
-// ATAPI device functions' prototype\r
-//\r
+**/\r
 EFI_STATUS\r
 ATAPIIdentify (\r
   IN  IDE_BLK_IO_DEV  *IdeDev\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtapiInquiry (\r
   IN  IDE_BLK_IO_DEV  *IdeDev\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  Packet TODO: add argument description\r
+  @param  Buffer TODO: add argument description\r
+  @param  ByteCount TODO: add argument description\r
+  @param  TimeOut TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtapiPacketCommandIn (\r
   IN  IDE_BLK_IO_DEV        *IdeDev,\r
@@ -832,27 +612,20 @@ AtapiPacketCommandIn (
   IN  UINT32                ByteCount,\r
   IN  UINTN                 TimeOut\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev    - TODO: add argument description\r
-  Packet    - TODO: add argument description\r
-  Buffer    - TODO: add argument description\r
-  ByteCount - TODO: add argument description\r
-  TimeOut   - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  Packet TODO: add argument description\r
+  @param  Buffer TODO: add argument description\r
+  @param  ByteCount TODO: add argument description\r
+  @param  TimeOut TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtapiPacketCommandOut (\r
   IN  IDE_BLK_IO_DEV        *IdeDev,\r
@@ -861,27 +634,20 @@ AtapiPacketCommandOut (
   IN  UINT32                ByteCount,\r
   IN  UINTN                 TimeOut\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev    - TODO: add argument description\r
-  Packet    - TODO: add argument description\r
-  Buffer    - TODO: add argument description\r
-  ByteCount - TODO: add argument description\r
-  TimeOut   - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  Buffer TODO: add argument description\r
+  @param  ByteCount TODO: add argument description\r
+  @param  Read TODO: add argument description\r
+  @param  TimeOut TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 PioReadWriteData (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
@@ -890,115 +656,79 @@ PioReadWriteData (
   IN  BOOLEAN         Read,\r
   IN  UINTN           TimeOut\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev    - TODO: add argument description\r
-  Buffer    - TODO: add argument description\r
-  ByteCount - TODO: add argument description\r
-  Read      - TODO: add argument description\r
-  TimeOut   - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtapiTestUnitReady (\r
   IN  IDE_BLK_IO_DEV  *IdeDev\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  SenseCounts TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtapiRequestSense (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
   OUT UINTN           *SenseCounts\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev      - TODO: add argument description\r
-  SenseCounts - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtapiReadCapacity (\r
   IN  IDE_BLK_IO_DEV  *IdeDev\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  MediaChange TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtapiDetectMedia (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
   OUT BOOLEAN         *MediaChange\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev      - TODO: add argument description\r
-  MediaChange - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  Buffer TODO: add argument description\r
+  @param  Lba TODO: add argument description\r
+  @param  NumberOfBlocks TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtapiReadSectors (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
@@ -1006,26 +736,19 @@ AtapiReadSectors (
   IN  EFI_LBA         Lba,\r
   IN  UINTN           NumberOfBlocks\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev          - TODO: add argument description\r
-  Buffer          - TODO: add argument description\r
-  Lba             - TODO: add argument description\r
-  NumberOfBlocks  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  Buffer TODO: add argument description\r
+  @param  Lba TODO: add argument description\r
+  @param  NumberOfBlocks TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtapiWriteSectors (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
@@ -1033,47 +756,34 @@ AtapiWriteSectors (
   IN  EFI_LBA         Lba,\r
   IN  UINTN           NumberOfBlocks\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev          - TODO: add argument description\r
-  Buffer          - TODO: add argument description\r
-  Lba             - TODO: add argument description\r
-  NumberOfBlocks  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtapiSoftReset (\r
   IN  IDE_BLK_IO_DEV  *IdeDev\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeBlkIoDevice TODO: add argument description\r
+  @param  MediaId TODO: add argument description\r
+  @param  LBA TODO: add argument description\r
+  @param  BufferSize TODO: add argument description\r
+  @param  Buffer TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtapiBlkIoReadBlocks (\r
   IN IDE_BLK_IO_DEV   *IdeBlkIoDevice,\r
@@ -1082,27 +792,20 @@ AtapiBlkIoReadBlocks (
   IN UINTN            BufferSize,\r
   OUT VOID            *Buffer\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeBlkIoDevice  - TODO: add argument description\r
-  MediaId         - TODO: add argument description\r
-  LBA             - TODO: add argument description\r
-  BufferSize      - TODO: add argument description\r
-  Buffer          - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeBlkIoDevice TODO: add argument description\r
+  @param  MediaId TODO: add argument description\r
+  @param  LBA TODO: add argument description\r
+  @param  BufferSize TODO: add argument description\r
+  @param  Buffer TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtapiBlkIoWriteBlocks (\r
   IN IDE_BLK_IO_DEV   *IdeBlkIoDevice,\r
@@ -1111,259 +814,185 @@ AtapiBlkIoWriteBlocks (
   IN UINTN            BufferSize,\r
   OUT VOID            *Buffer\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeBlkIoDevice  - TODO: add argument description\r
-  MediaId         - TODO: add argument description\r
-  LBA             - TODO: add argument description\r
-  BufferSize      - TODO: add argument description\r
-  Buffer          - TODO: add argument description\r
-\r
-Returns:\r
+  @param  SenseData TODO: add argument description\r
+  @param  SenseCounts TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 BOOLEAN\r
 IsNoMedia (\r
   IN  REQUEST_SENSE_DATA    *SenseData,\r
   IN  UINTN                 SenseCounts\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  SenseData   - TODO: add argument description\r
-  SenseCounts - TODO: add argument description\r
-\r
-Returns:\r
+  @param  SenseData TODO: add argument description\r
+  @param  SenseCounts TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 BOOLEAN\r
 IsMediaError (\r
   IN  REQUEST_SENSE_DATA    *SenseData,\r
   IN  UINTN                 SenseCounts\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  SenseData   - TODO: add argument description\r
-  SenseCounts - TODO: add argument description\r
-\r
-Returns:\r
+  @param  SenseData TODO: add argument description\r
+  @param  SenseCounts TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 BOOLEAN\r
 IsMediaChange (\r
   IN  REQUEST_SENSE_DATA    *SenseData,\r
   IN  UINTN                 SenseCounts\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  SenseData   - TODO: add argument description\r
-  SenseCounts - TODO: add argument description\r
-\r
-Returns:\r
+  @param  SenseData TODO: add argument description\r
+  @param  SenseCounts TODO: add argument description\r
+  @param  NeedRetry TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 BOOLEAN\r
 IsDriveReady (\r
   IN  REQUEST_SENSE_DATA    *SenseData,\r
   IN  UINTN                 SenseCounts,\r
   OUT BOOLEAN               *NeedRetry\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  SenseData   - TODO: add argument description\r
-  SenseCounts - TODO: add argument description\r
-  NeedRetry   - TODO: add argument description\r
-\r
-Returns:\r
+  @param  SenseData TODO: add argument description\r
+  @param  SenseCounts TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 BOOLEAN\r
 HaveSenseKey (\r
   IN  REQUEST_SENSE_DATA    *SenseData,\r
   IN  UINTN                 SenseCounts\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  SenseData   - TODO: add argument description\r
-  SenseCounts - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  WriteProtected TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 IsLS120orZipWriteProtected (\r
   IN  IDE_BLK_IO_DEV    *IdeDev,\r
   OUT BOOLEAN           *WriteProtected\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev          - TODO: add argument description\r
-  WriteProtected  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeBlkIoDevice TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 VOID\r
 ReleaseIdeResources (\r
   IN  IDE_BLK_IO_DEV  *IdeBlkIoDevice\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeBlkIoDevice  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  TransferMode TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 SetDeviceTransferMode (\r
   IN IDE_BLK_IO_DEV       *IdeDev,\r
   IN ATA_TRANSFER_MODE    *TransferMode\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev        - TODO: add argument description\r
-  TransferMode  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  NativeMaxAddress TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 ReadNativeMaxAddress (\r
   IN  IDE_BLK_IO_DEV                *IdeDev,\r
   OUT EFI_LBA                       *NativeMaxAddress\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev            - TODO: add argument description\r
-  NativeMaxAddress  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  MaxAddress TODO: add argument description\r
+  @param  bVolatile TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 SetMaxAddress (\r
   IN  IDE_BLK_IO_DEV                *IdeDev,\r
   IN  EFI_LBA                       MaxAddress,\r
   IN  BOOLEAN                       bVolatile\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev      - TODO: add argument description\r
-  MaxAddress  - TODO: add argument description\r
-  bVolatile   - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  AtaCommand TODO: add argument description\r
+  @param  Device TODO: add argument description\r
+  @param  Feature TODO: add argument description\r
+  @param  SectorCount TODO: add argument description\r
+  @param  LbaLow TODO: add argument description\r
+  @param  LbaMiddle TODO: add argument description\r
+  @param  LbaHigh TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtaNonDataCommandIn (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
@@ -1375,30 +1004,21 @@ AtaNonDataCommandIn (
   IN  UINT8           LbaMiddle,\r
   IN  UINT8           LbaHigh\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev      - TODO: add argument description\r
-  AtaCommand  - TODO: add argument description\r
-  Device      - TODO: add argument description\r
-  Feature     - TODO: add argument description\r
-  SectorCount - TODO: add argument description\r
-  LbaLow      - TODO: add argument description\r
-  LbaMiddle   - TODO: add argument description\r
-  LbaHigh     - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  AtaCommand TODO: add argument description\r
+  @param  Device TODO: add argument description\r
+  @param  Feature TODO: add argument description\r
+  @param  SectorCount TODO: add argument description\r
+  @param  LbaAddress TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtaNonDataCommandInExt (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
@@ -1408,28 +1028,19 @@ AtaNonDataCommandInExt (
   IN  UINT16          SectorCount,\r
   IN  EFI_LBA         LbaAddress\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev      - TODO: add argument description\r
-  AtaCommand  - TODO: add argument description\r
-  Device      - TODO: add argument description\r
-  Feature     - TODO: add argument description\r
-  SectorCount - TODO: add argument description\r
-  LbaAddress  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  DataBuffer TODO: add argument description\r
+  @param  StartLba TODO: add argument description\r
+  @param  NumberOfBlocks TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtaReadSectorsExt (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
@@ -1437,26 +1048,19 @@ AtaReadSectorsExt (
   IN  EFI_LBA         StartLba,\r
   IN  UINTN           NumberOfBlocks\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev          - TODO: add argument description\r
-  DataBuffer      - TODO: add argument description\r
-  StartLba        - TODO: add argument description\r
-  NumberOfBlocks  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  DataBuffer TODO: add argument description\r
+  @param  StartLba TODO: add argument description\r
+  @param  NumberOfBlocks TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtaWriteSectorsExt (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
@@ -1464,26 +1068,19 @@ AtaWriteSectorsExt (
   IN  EFI_LBA         StartLba,\r
   IN  UINTN           NumberOfBlocks\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev          - TODO: add argument description\r
-  DataBuffer      - TODO: add argument description\r
-  StartLba        - TODO: add argument description\r
-  NumberOfBlocks  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  DataBuffer TODO: add argument description\r
+  @param  StartLba TODO: add argument description\r
+  @param  NumberOfBlocks TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtaUdmaReadExt (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
@@ -1491,26 +1088,19 @@ AtaUdmaReadExt (
   IN  EFI_LBA         StartLba,\r
   IN  UINTN           NumberOfBlocks\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev          - TODO: add argument description\r
-  DataBuffer      - TODO: add argument description\r
-  StartLba        - TODO: add argument description\r
-  NumberOfBlocks  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  DataBuffer TODO: add argument description\r
+  @param  StartLba TODO: add argument description\r
+  @param  NumberOfBlocks TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtaUdmaRead (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
@@ -1518,26 +1108,19 @@ AtaUdmaRead (
   IN  EFI_LBA         StartLba,\r
   IN  UINTN           NumberOfBlocks\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev          - TODO: add argument description\r
-  DataBuffer      - TODO: add argument description\r
-  StartLba        - TODO: add argument description\r
-  NumberOfBlocks  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  DataBuffer TODO: add argument description\r
+  @param  StartLba TODO: add argument description\r
+  @param  NumberOfBlocks TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtaUdmaWriteExt (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
@@ -1545,26 +1128,19 @@ AtaUdmaWriteExt (
   IN  EFI_LBA         StartLba,\r
   IN  UINTN           NumberOfBlocks\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev          - TODO: add argument description\r
-  DataBuffer      - TODO: add argument description\r
-  StartLba        - TODO: add argument description\r
-  NumberOfBlocks  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  DataBuffer TODO: add argument description\r
+  @param  StartLba TODO: add argument description\r
+  @param  NumberOfBlocks TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtaUdmaWrite (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
@@ -1572,26 +1148,21 @@ AtaUdmaWrite (
   IN  EFI_LBA         StartLba,\r
   IN  UINTN           NumberOfBlocks\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev          - TODO: add argument description\r
-  DataBuffer      - TODO: add argument description\r
-  StartLba        - TODO: add argument description\r
-  NumberOfBlocks  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  AtaCommand TODO: add argument description\r
+  @param  Device TODO: add argument description\r
+  @param  Feature TODO: add argument description\r
+  @param  SectorCount TODO: add argument description\r
+  @param  LbaAddress TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtaCommandIssueExt (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
@@ -1601,28 +1172,21 @@ AtaCommandIssueExt (
   IN  UINT16          SectorCount,\r
   IN  EFI_LBA         LbaAddress\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev      - TODO: add argument description\r
-  AtaCommand  - TODO: add argument description\r
-  Device      - TODO: add argument description\r
-  Feature     - TODO: add argument description\r
-  SectorCount - TODO: add argument description\r
-  LbaAddress  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  AtaCommand TODO: add argument description\r
+  @param  Device TODO: add argument description\r
+  @param  Feature TODO: add argument description\r
+  @param  SectorCount TODO: add argument description\r
+  @param  LbaAddress TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtaCommandIssue (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
@@ -1632,71 +1196,50 @@ AtaCommandIssue (
   IN  UINT16          SectorCount,\r
   IN  EFI_LBA         LbaAddress\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev      - TODO: add argument description\r
-  AtaCommand  - TODO: add argument description\r
-  Device      - TODO: add argument description\r
-  Feature     - TODO: add argument description\r
-  SectorCount - TODO: add argument description\r
-  LbaAddress  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtaAtapi6Identify (\r
   IN  IDE_BLK_IO_DEV  *IdeDev\r
   )\r
-/*++\r
+;\r
 \r
-Routine Description:\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
-\r
+**/\r
 VOID\r
 AtaSMARTSupport (\r
   IN  IDE_BLK_IO_DEV  *IdeDev\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev  - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  Buffer TODO: add argument description\r
+  @param  ByteCount TODO: add argument description\r
+  @param  AtaCommand TODO: add argument description\r
+  @param  StartLba TODO: add argument description\r
+  @param  SectorCount TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtaPioDataInExt (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
@@ -1706,28 +1249,21 @@ AtaPioDataInExt (
   IN  EFI_LBA         StartLba,\r
   IN  UINT16          SectorCount\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev      - TODO: add argument description\r
-  Buffer      - TODO: add argument description\r
-  ByteCount   - TODO: add argument description\r
-  AtaCommand  - TODO: add argument description\r
-  StartLba    - TODO: add argument description\r
-  SectorCount - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  Buffer TODO: add argument description\r
+  @param  ByteCount TODO: add argument description\r
+  @param  AtaCommand TODO: add argument description\r
+  @param  StartLba TODO: add argument description\r
+  @param  SectorCount TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 AtaPioDataOutExt (\r
   IN  IDE_BLK_IO_DEV  *IdeDev,\r
@@ -1737,70 +1273,36 @@ AtaPioDataOutExt (
   IN  EFI_LBA         StartLba,\r
   IN  UINT16          SectorCount\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev      - TODO: add argument description\r
-  Buffer      - TODO: add argument description\r
-  ByteCount   - TODO: add argument description\r
-  AtaCommand  - TODO: add argument description\r
-  StartLba    - TODO: add argument description\r
-  SectorCount - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
+  @param  DriveParameters TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 SetDriveParameters (\r
   IN IDE_BLK_IO_DEV       *IdeDev,\r
   IN ATA_DRIVE_PARMS      *DriveParameters\r
   )\r
-/*++\r
-\r
-Routine Description:\r
+;\r
 \r
+/**\r
   TODO: Add function description\r
 \r
-Arguments:\r
-\r
-  IdeDev          - TODO: add argument description\r
-  DriveParameters - TODO: add argument description\r
-\r
-Returns:\r
+  @param  IdeDev TODO: add argument description\r
 \r
   TODO: add return values\r
 \r
---*/\r
-;\r
-\r
+**/\r
 EFI_STATUS\r
 EnableInterrupt (\r
   IN IDE_BLK_IO_DEV       *IdeDev\r
   )\r
-/*++\r
-\r
-Routine Description:\r
-\r
-  TODO: Add function description\r
-\r
-Arguments:\r
-\r
-  IdeDev  - TODO: add argument description\r
-\r
-Returns:\r
-\r
-  TODO: add return values\r
-\r
---*/\r
 ;\r
 \r
 #endif\r