Fix minor coding style issues.

[mirror_edk2.git] / MdeModulePkg / Bus / Ata / AtaBusDxe / AtaBus.c

diff --git a/MdeModulePkg/Bus/Ata/AtaBusDxe/AtaBus.c b/MdeModulePkg/Bus/Ata/AtaBusDxe/AtaBus.c
index e46b071a73b6358782e794abf627e1333867fe46..71128745e53bc1074746f7904e4ac4d0e3b94572 100644 (file)
--- a/MdeModulePkg/Bus/Ata/AtaBusDxe/AtaBus.c
+++ b/MdeModulePkg/Bus/Ata/AtaBusDxe/AtaBus.c
@@ -34,8 +34,8 @@ EFI_DRIVER_BINDING_PROTOCOL gAtaBusDriverBinding = {
 // Template for ATA Child Device.\r
 //\r
 ATA_DEVICE gAtaDeviceTemplate = {\r
-  ATA_DEVICE_SIGNATURE,        // Signature; \r
-  NULL,                        // Handle;\r
+  ATA_DEVICE_SIGNATURE,        // Signature\r
+  NULL,                        // Handle\r
   {                            // BlockIo\r
     EFI_BLOCK_IO_PROTOCOL_REVISION,\r
     NULL,\r
@@ -52,10 +52,10 @@ ATA_DEVICE gAtaDeviceTemplate = {
     FALSE,                     // ReadOnly\r
     FALSE,                     // WritingCache\r
     0x200,                     // BlockSize \r
+    0,                         // IoAlign\r
     0,                         // LastBlock\r
-    4,                         // IoAlign\r
-    1,                         // LogicalBlocksPerPhysicalBlock\r
-    0                          // LowestAlignedLba\r
+    0,                         // LowestAlignedLba\r
+    1                          // LogicalBlocksPerPhysicalBlock\r
   },\r
   {                            // DiskInfo\r
     EFI_DISK_INFO_IDE_INTERFACE_GUID,\r
@@ -64,10 +64,10 @@ ATA_DEVICE gAtaDeviceTemplate = {
     AtaDiskInfoSenseData,\r
     AtaDiskInfoWhichIde\r
   },\r
-  NULL,                        // DevicePath;\r
-  NULL,                        // AtaBusDriverData;\r
-  0,                           // Port,\r
-  0,                           // PortMultiplierPort;\r
+  NULL,                        // DevicePath\r
+  NULL,                        // AtaBusDriverData\r
+  0,                           // Port\r
+  0,                           // PortMultiplierPort\r
   { 0, },                      // Packet\r
   {{ 0}, },                    // Acb\r
   NULL,                        // Asb\r
@@ -106,7 +106,7 @@ AllocateAlignedBuffer (
   This function frees an aligned buffer for the ATA device to perform\r
   ATA pass through operations.\r
 \r
-  @param  AtaDevice         The ATA child device involved for the operation.\r
+  @param  Buffer            The aligned buffer to be freed.\r
   @param  BufferSize        The request buffer size.\r
 \r
 **/\r
@@ -153,7 +153,7 @@ ReleaseAtaResources (
   Then it will create child handle and install Block IO and Disk Info protocol on\r
   it.\r
 \r
-  @param  AtaDevice             The ATA child device involved for the operation.\r
+  @param  AtaBusDriverData      The parent ATA bus driver data structure.\r
   @param  Port                  The port number of the ATA device.\r
   @param  PortMultiplierPort    The port multiplier port number of the ATA device.\r
 \r
@@ -299,7 +299,7 @@ Done:
   This function removes the protocols installed on the controller handle and \r
   frees the resources allocated for the ATA device. \r
 \r
-  @param  AtaDevice             The ATA child device involved for the operation.\r
+  @param  This                  The pointer to EFI_DRIVER_BINDING_PROTOCOL instance.\r
   @param  Controller            The controller handle of the ATA device.\r
   @param  Handle                The child handle.\r
 \r
@@ -787,6 +787,7 @@ AtaBlockIoReset (
                      responsible for reading/writing to only legitimate locations.\r
   @param  BufferSize Size of Buffer, must be a multiple of device block size.\r
   @param  Buffer     A pointer to the destination/source buffer for the data.\r
+  @param  IsWrite    Indicates whether it is a write operation.\r
 \r
   @retval EFI_SUCCESS           The data was read/written correctly to the device.\r
   @retval EFI_WRITE_PROTECTED   The device can not be read/written to.\r
@@ -958,9 +959,9 @@ AtaBlockIoFlushBlocks (
   This function is used by the IDE bus driver to get inquiry data.  Data format\r
   of Identify data is defined by the Interface GUID.\r
 \r
-  @param[in]     This              Pointer to the EFI_DISK_INFO_PROTOCOL instance.\r
-  @param[in,out] InquiryData       Pointer to a buffer for the inquiry data.\r
-  @param[in,out] InquiryDataSize   Pointer to the value for the inquiry data size.\r
+  @param[in]      This             Pointer to the EFI_DISK_INFO_PROTOCOL instance.\r
+  @param[in, out] InquiryData      Pointer to a buffer for the inquiry data.\r
+  @param[in, out] InquiryDataSize  Pointer to the value for the inquiry data size.\r
 \r
   @retval EFI_SUCCESS            The command was accepted without any errors.\r
   @retval EFI_NOT_FOUND          Device does not support this data class \r
@@ -986,10 +987,10 @@ AtaDiskInfoInquiry (
   This function is used by the IDE bus driver to get identify data.  Data format\r
   of Identify data is defined by the Interface GUID.\r
 \r
-  @param[in]     This               Pointer to the EFI_DISK_INFO_PROTOCOL \r
+  @param[in]      This              Pointer to the EFI_DISK_INFO_PROTOCOL \r
                                     instance.\r
-  @param[in,out] IdentifyData       Pointer to a buffer for the identify data.\r
-  @param[in,out] IdentifyDataSize   Pointer to the value for the identify data\r
+  @param[in, out] IdentifyData      Pointer to a buffer for the identify data.\r
+  @param[in, out] IdentifyDataSize  Pointer to the value for the identify data\r
                                     size.\r
 \r
   @retval EFI_SUCCESS            The command was accepted without any errors.\r
@@ -1028,10 +1029,10 @@ AtaDiskInfoIdentify (
   This function is used by the IDE bus driver to get sense data. \r
   Data format of Sense data is defined by the Interface GUID.\r
 \r
-  @param[in]     This              Pointer to the EFI_DISK_INFO_PROTOCOL instance.\r
-  @param[in,out] SenseData         Pointer to the SenseData.\r
-  @param[in,out] SenseDataSize     Size of SenseData in bytes.\r
-  @param[out]    SenseDataNumber   Pointer to the value for the sense data size.\r
+  @param[in]      This             Pointer to the EFI_DISK_INFO_PROTOCOL instance.\r
+  @param[in, out] SenseData        Pointer to the SenseData.\r
+  @param[in, out] SenseDataSize    Size of SenseData in bytes.\r
+  @param[out]     SenseDataNumber  Pointer to the value for the sense data size.\r
 \r
   @retval EFI_SUCCESS            The command was accepted without any errors.\r
   @retval EFI_NOT_FOUND          Device does not support this data class.\r