]> git.proxmox.com Git - mirror_edk2.git/blobdiff - IntelFrameworkPkg/Include/Protocol/LegacyBiosPlatform.h
Remove IntelFrameworkModulePkg
[mirror_edk2.git] / IntelFrameworkPkg / Include / Protocol / LegacyBiosPlatform.h
index 005d327f58b311f1b86f6b5a16e701b5a6468bb6..0a164dad3bde9ca53f1d3d931d32f436857bc4af 100644 (file)
@@ -4,16 +4,8 @@
   the Legacy BIOS protocol is generic and consumes this protocol.\r
   A driver that matches the Legacy16 produces this protocol\r
 \r
-  Copyright (c) 2007,2009  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
-\r
-  Module Name:  LegacyBiosPlatform.h\r
+Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>\r
+SPDX-License-Identifier: BSD-2-Clause-Patent\r
 \r
   @par Revision Reference:\r
   This protocol is defined in Framework for EFI Compatibility Support Module spec\r
 #ifndef _EFI_LEGACY_BIOS_PLATFORM_H_\r
 #define _EFI_LEGACY_BIOS_PLATFORM_H_\r
 \r
-#include <FrameworkDxe.h>\r
+///\r
+/// Legacy BIOS Platform depends on HDD_INFO and EFI_COMPATIBILITY16_TABLE that\r
+/// are defined with the Legacy BIOS Protocol\r
+///\r
+#include <Protocol/LegacyBios.h>\r
 \r
 #define EFI_LEGACY_BIOS_PLATFORM_PROTOCOL_GUID \\r
   { \\r
 typedef struct _EFI_LEGACY_BIOS_PLATFORM_PROTOCOL EFI_LEGACY_BIOS_PLATFORM_PROTOCOL;\r
 \r
 /**\r
-       This enum specifies the Mode param values for GetPlatformInfo()\r
+  This enum specifies the Mode param values for GetPlatformInfo()\r
 **/\r
 typedef enum {\r
-       ///\r
-       /// This mode is invoked twice. The first invocation has LegacySegment and\r
-       /// LegacyOffset set to 0. The mode returns the MP table address in EFI memory and its size.\r
-       /// The second invocation has LegacySegment and LegacyOffset set to the location\r
-       /// in the 0xF0000 or 0xE0000 block to which the MP table is to be copied. The second\r
-       /// invocation allows any MP table address fix ups to occur in the EFI memory copy of the\r
-       /// MP table. The caller, not EfiGetPlatformBinaryMpTable, copies the modified MP\r
-       /// table to the allocated region in 0xF0000 or 0xE0000 block after the second invocation.\r
-       ///\r
-       /// The function parameters associated with this mode are:\r
-       ///\r
-       ///             Table Pointer to the MP table.\r
-       ///\r
-       ///             TableSize Size in bytes of the MP table.\r
-       ///\r
-       ///             Location Location to place table. 0x00. Either 0xE0000 or 0xF0000 64 KB blocks.\r
-       ///                             Bit 0 = 1 0xF0000 64 KB block.\r
-       ///                             Bit 1 = 1 0xE0000 64 KB block.\r
-       ///                             Multiple bits can be set.\r
-       ///\r
-       ///             Alignment Bit mapped address alignment granularity. \r
-       ///                     The first nonzero bit from the right is the address granularity.\r
-       ///\r
-       ///             LegacySegment Segment where EfiCompatibility code will place the MP table.\r
-       ///\r
-       ///             LegacyOffset Offset where EfiCompatibility code will place the MP table.\r
-       ///\r
-       ///     The return values associated with this mode are:\r
-       ///\r
-       ///             EFI_SUCCESS The MP table was returned.\r
-       ///\r
-       ///             EFI_UNSUPPORTED The MP table is not supported on this platform.\r
-       ///\r
+  ///\r
+  /// This mode is invoked twice. The first invocation has LegacySegment and\r
+  /// LegacyOffset set to 0. The mode returns the MP table address in EFI memory, along with its size.\r
+  /// The second invocation has LegacySegment and LegacyOffset set to the location\r
+  /// in the 0xF0000 or 0xE0000 block to which the MP table is to be copied. The second\r
+  /// invocation allows any MP table address fixes to occur in the EFI memory copy of the\r
+  /// MP table. The caller, not EfiGetPlatformBinaryMpTable, copies the modified MP\r
+  /// table to the allocated region in 0xF0000 or 0xE0000 block after the second invocation.\r
+  ///\r
+  /// The function parameters associated with this mode are:\r
+  ///\r
+  ///   Table Pointer to the MP table.\r
+  ///\r
+  ///   TableSize Size in bytes of the MP table.\r
+  ///\r
+  ///   Location Location to place table. 0x00. Either 0xE0000 or 0xF0000 64 KB blocks.\r
+  ///     Bit 0 = 1 0xF0000 64 KB block.\r
+  ///     Bit 1 = 1 0xE0000 64 KB block.\r
+  ///     Multiple bits can be set.\r
+  ///\r
+  ///   Alignment Bit-mapped address alignment granularity.\r
+  ///     The first nonzero bit from the right is the address granularity.\r
+  ///\r
+  //    LegacySegment Segment in which EfiCompatibility code will place the MP table.\r
+  ///\r
+  ///   LegacyOffset Offset in which EfiCompatibility code will place the MP table.\r
+  ///\r
+  /// The return values associated with this mode are:\r
+  ///\r
+  ///   EFI_SUCCESS The MP table was returned.\r
+  ///\r
+  ///   EFI_UNSUPPORTED The MP table is not supported on this platform.\r
+  ///\r
   EfiGetPlatformBinaryMpTable      = 0,\r
-       ///\r
-       /// This mode returns a block of data. The contents and usage is IBV or OEM defined.\r
-       /// OEMs or IBVs normally use this function for nonstandard Compatibility16 runtime soft\r
-       /// INTs. It is the responsibility of this routine to coalesce multiple OEM 16 bit functions, if\r
-       /// they exist, into one coherent package that is understandable by the Compatibility16 code.\r
-       /// This function is invoked twice. The first invocation has LegacySegment and\r
-       /// LegacyOffset set to 0. The function returns the table address in EFI memory and its size.\r
-       /// The second invocation has LegacySegment and LegacyOffset set to the location\r
-       /// in the 0xF0000 or 0xE0000 block to which the data (table) is to be copied. The second\r
-       /// invocation allows any data (table) address fix ups to occur in the EFI memory copy of\r
-       /// the table. The caller, not GetOemIntData(), copies the modified data (table) to the\r
-       /// allocated region in 0xF0000 or 0xE0000 block after the second invocation.\r
-       ///\r
-       /// The function parameters associated with this mode are:\r
-       ///\r
-       ///             Table Pointer to OEM legacy 16 bit code or data.\r
-       ///\r
-       ///             TableSize Size of data.\r
-       ///\r
-       ///             Location Location to place table. 0x00. Either 0xE0000 or 0xF0000 64 KB blocks.\r
-       ///                             Bit 0 = 1 0xF0000 64 KB block.\r
-       ///                             Bit 1 = 1 0xE0000 64 KB block.\r
-       ///                             Multiple bits can be set.\r
-       ///\r
-       ///             Alignment Bit mapped address alignment granularity. \r
-       ///                     The first nonzero bit from the right is the address granularity.\r
-       ///\r
-       ///             LegacySegment Segment where EfiCompatibility code will place the table or data.\r
-       ///\r
-       ///             LegacyOffset Offset where EfiCompatibility code will place the table or data.\r
-       ///\r
-       ///     The return values associated with this mode are:\r
-       ///\r
-       ///             EFI_SUCCESS The data was returned successfully.\r
-       ///\r
-       ///             EFI_UNSUPPORTED Oem INT is not supported on this platform.\r
-       ///\r
+  ///\r
+  /// This mode returns a block of data. The content and usage is IBV or OEM defined.\r
+  /// OEMs or IBVs normally use this function for nonstandard Compatibility16 runtime soft\r
+  /// INTs. It is the responsibility of this routine to coalesce multiple OEM 16 bit functions, if\r
+  /// they exist, into one coherent package that is understandable by the Compatibility16 code.\r
+  /// This function is invoked twice. The first invocation has LegacySegment and\r
+  /// LegacyOffset set to 0. The function returns the table address in EFI memory, as well as its size.\r
+  /// The second invocation has LegacySegment and LegacyOffset set to the location\r
+  /// in the 0xF0000 or 0xE0000 block to which the data (table) is to be copied. The second\r
+  /// invocation allows any data (table) address fixes to occur in the EFI memory copy of\r
+  /// the table. The caller, not GetOemIntData(), copies the modified data (table) to the\r
+  /// allocated region in 0xF0000 or 0xE0000 block after the second invocation.\r
+  ///\r
+  /// The function parameters associated with this mode are:\r
+  ///\r
+  ///   Table Pointer to OEM legacy 16 bit code or data.\r
+  ///\r
+  ///   TableSize Size of data.\r
+  ///\r
+  ///   Location Location to place table. 0x00. Either 0xE0000 or 0xF0000 64 KB blocks.\r
+  ///       Bit 0 = 1 0xF0000 64 KB block.\r
+  ///       Bit 1 = 1 0xE0000 64 KB block.\r
+  ///       Multiple bits can be set.\r
+  ///\r
+  ///   Alignment Bit mapped address alignment granularity.\r
+  ///     The first nonzero bit from the right is the address granularity.\r
+  ///\r
+  ///   LegacySegment Segment in which EfiCompatibility code will place the table or data.\r
+  ///\r
+  ///   LegacyOffset Offset in which EfiCompatibility code will place the table or data.\r
+  ///\r
+  /// The return values associated with this mode are:\r
+  ///\r
+  ///   EFI_SUCCESS The data was returned successfully.\r
+  ///\r
+  ///   EFI_UNSUPPORTED Oem INT is not supported on this platform.\r
+  ///\r
   EfiGetPlatformBinaryOemIntData   = 1,\r
-       ///\r
-       /// This mode returns a block of data. The contents and usage is IBV defined. OEMs or\r
-       /// IBVs normally use this mode for nonstandard Compatibility16 runtime 16 bit routines. It\r
-       /// is the responsibility of this routine to coalesce multiple OEM 16 bit functions, if they\r
-       /// exist, into one coherent package that is understandable by the Compatibility16 code.\r
-       /// An example usage might be a legacy mobile BIOS that has a pre existing runtime\r
-       /// interface to return the battery status to calling applications.\r
-       /// This mode is invoked twice. The first invocation has LegacySegment and\r
-       /// LegacyOffset set to 0. The mode returns the table address in EFI memory and its size.\r
-       /// The second invocation has LegacySegment and LegacyOffset set to the location\r
-       /// in the 0xF0000 or 0xE0000 block to which the table is to be copied. The second\r
-       /// invocation allows any table address fix ups to occur in the EFI memory copy of the table.\r
-       /// The caller, not EfiGetPlatformBinaryOem16Data, copies the modified table to\r
-       /// the allocated region in 0xF0000 or 0xE0000 block after the second invocation.\r
-       ///\r
-       /// The function parameters associated with this mode are:\r
-       ///\r
-       ///             Table Pointer to OEM legacy 16 bit code or data.\r
-       ///\r
-       ///             TableSize Size of data.\r
-       ///\r
-       ///             Location Location to place the table. 0x00. Either 0xE0000 or 0xF0000 64 KB blocks.\r
-       ///                             Bit 0 = 1 0xF0000 64 KB block.\r
-       ///                             Bit 1 = 1 0xE0000 64 KB block.\r
-       ///                             Multiple bits can be set.\r
-       ///\r
-       ///             Alignment Bit mapped address alignment granularity. \r
-       ///                     The first nonzero bit from the right is the address granularity.\r
-       ///\r
-       ///             LegacySegment Segment where EfiCompatibility code will place the table or data.\r
-       ///\r
-       ///             LegacyOffset Offset where EfiCompatibility code will place the table or data.\r
-       ///\r
-       ///     The return values associated with this mode are:\r
-       ///\r
-       ///             EFI_SUCCESS The data was returned successfully.\r
-       ///\r
-       ///             EFI_UNSUPPORTED Oem16 is not supported on this platform.\r
-       ///\r
+  ///\r
+  /// This mode returns a block of data. The content and usage is IBV defined. OEMs or\r
+  /// IBVs normally use this mode for nonstandard Compatibility16 runtime 16 bit routines. It\r
+  /// is the responsibility of this routine to coalesce multiple OEM 16 bit functions, if they\r
+  /// exist, into one coherent package that is understandable by the Compatibility16 code.\r
+  ///\r
+  /// Example usage: A legacy mobile BIOS that has a pre-existing runtime\r
+  /// interface to return the battery status to calling applications.\r
+  ///\r
+  /// This mode is invoked twice. The first invocation has LegacySegment and\r
+  /// LegacyOffset set to 0. The mode returns the table address in EFI memory and its size.\r
+  /// The second invocation has LegacySegment and LegacyOffset set to the location\r
+  /// in the 0xF0000 or 0xE0000 block to which the table is to be copied. The second\r
+  /// invocation allows any table address fixes to occur in the EFI memory copy of the table.\r
+  /// The caller, not EfiGetPlatformBinaryOem16Data, copies the modified table to\r
+  /// the allocated region in 0xF0000 or 0xE0000 block after the second invocation.\r
+  ///\r
+  /// The function parameters associated with this mode are:\r
+  ///\r
+  ///   Table Pointer to OEM legacy 16 bit code or data.\r
+  ///\r
+  ///   TableSize Size of data.\r
+  ///\r
+  ///   Location Location to place the table. 0x00. Either 0xE0000 or 0xF0000 64 KB blocks.\r
+  ///      Bit 0 = 1 0xF0000 64 KB block.\r
+  ///      Bit 1 = 1 0xE0000 64 KB block.\r
+  ///      Multiple bits can be set.\r
+  ///\r
+  ///   Alignment Bit mapped address alignment granularity.\r
+  ///     The first nonzero bit from the right is the address granularity.\r
+  ///\r
+  ///   LegacySegment Segment in which EfiCompatibility code will place the table or data.\r
+  ///\r
+  ///   LegacyOffset Offset in which EfiCompatibility code will place the table or data.\r
+  ///\r
+  /// The return values associated with this mode are:\r
+  ///\r
+  ///   EFI_SUCCESS The data was returned successfully.\r
+  ///\r
+  ///   EFI_UNSUPPORTED Oem16 is not supported on this platform.\r
+  ///\r
   EfiGetPlatformBinaryOem16Data    = 2,\r
-       ///\r
-       /// This mode returns a block of data. The contents and usage is IBV defined. OEMs or\r
-       /// IBVs normally use this mode for nonstandard Compatibility16 runtime 32 bit routines. It\r
-       /// is the responsibility of this routine to coalesce multiple OEM 32 bit functions, if they\r
-       /// exist, into one coherent package that is understandable by the Compatibility16 code.\r
-       /// An example usage might be a legacy mobile BIOS that has a pre existing runtime\r
-       /// interface to return the battery status to calling applications.\r
-       /// This mode is invoked twice. The first invocation has LegacySegment and\r
-       /// LegacyOffset set to 0. The mode returns the table address in EFI memory and its size.\r
-       /// \r
-       /// The second invocation has LegacySegment and LegacyOffset set to the location\r
-       /// in the 0xF0000 or 0xE0000 block to which the table is to be copied. The second\r
-       /// invocation allows any table address fix ups to occur in the EFI memory copy of the table.\r
-       /// The caller, not EfiGetPlatformBinaryOem32Data, copies the modified table to\r
-       /// the allocated region in 0xF0000 or 0xE0000 block after the second invocation..\r
-       ///\r
-       /// Note: There are two generic mechanisms by which this mode can be used.\r
-       ///  - Mechanism 1: This mode returns the data and the Legacy BIOS Protocol copies\r
-       /// the data into the F0000 or E0000 block in the Compatibility16 code. The\r
-       /// EFI_COMPATIBILITY16_TABLE entries Oem32Segment and Oem32Offset can\r
-       /// be viewed as two UINT16 entries.\r
-       /// - Mechanism 2: This mode directly fills in the EFI_COMPATIBILITY16_TABLE with\r
-       /// a pointer to the INT15 E820 region containing the 32 bit code. It returns\r
-       /// EFI_UNSUPPORTED. The EFI_COMPATIBILITY16_TABLE entries,\r
-       /// Oem32Segment and Oem32Offset, can be viewed as two UINT16 entries or\r
-       /// as a single UINT32 entry as determined by the IBV.\r
-       ///\r
-       /// The function parameters associated with this mode are:\r
-       ///\r
-       ///             TableSize Size of data.\r
-       ///\r
-       ///             Location Location to place the table. 0x00 \96 Either 0xE0000 or 0xF0000 64 KB blocks.\r
-       ///                             Bit 0 = 1 0xF0000 64 KB block.\r
-       ///                             Bit 1 = 1 0xE0000 64 KB block.\r
-       ///                             Multiple bits can be set.\r
-       ///\r
-       ///             Alignment Bit mapped address alignment granularity. \r
-       ///                             The first nonzero bit from the right is the address granularity.\r
-       ///\r
-       ///             LegacySegment Segment where EfiCompatibility code will place the table or data.\r
-       ///\r
-       ///             LegacyOffset Offset where EfiCompatibility code will place the table or data.\r
-       ///\r
-       ///     The return values associated with this mode are:\r
-       ///             EFI_SUCCESS The data was returned successfully.\r
-       ///             EFI_UNSUPPORTED Oem32 is not supported on this platform.\r
-       ///\r
-  EfiGetPlatformBinaryOem32Data    = 3,\r
-       ///\r
-       /// This mode returns a TPM binary image for the onboard TPM device.\r
-       ///\r
-       /// The function parameters associated with this mode are:\r
-       ///\r
-       ///             Table TPM binary image for the onboard TPM device.\r
-       ///\r
-       ///             TableSize Size of BinaryImage in bytes.\r
-       ///\r
-       ///             Location Location to place the table. 0x00. Either 0xE0000 or 0xF0000 64 KB blocks.\r
-       ///                             Bit 0 = 1 0xF0000 64 KB block.\r
-       ///                             Bit 1 = 1 0xE0000 64 KB block.\r
-       ///                             Multiple bits can be set.\r
-       ///\r
-       ///             Alignment Bit mapped address alignment granularity. \r
-       ///                             The first nonzero bit from the right is the address granularity.\r
-       ///\r
-       ///             LegacySegment Segment where EfiCompatibility code will place the table or data.\r
-       ///\r
-       ///             LegacyOffset Offset where EfiCompatibility code will place the table or data.\r
-       ///\r
-       ///     The return values associated with this mode are:\r
-       ///\r
-       ///             EFI_SUCCESS BinaryImage is valid.\r
-       ///\r
-       ///             EFI_UNSUPPORTED Mode is not supported on this platform.\r
-       ///\r
-       ///             EFI_NOT_FOUND No BinaryImage was found.\r
-       ///\r
+///\r
+/// This mode returns a block of data. The content and usage are IBV defined. OEMs or\r
+/// IBVs normally use this mode for nonstandard Compatibility16 runtime 32 bit routines. It\r
+/// is the responsibility of this routine to coalesce multiple OEM 32 bit functions, if they\r
+/// exist, into one coherent package that is understandable by the Compatibility16 code.\r
+///\r
+/// Example usage: A legacy mobile BIOS that has a pre existing runtime\r
+/// interface to return the battery status to calling applications.\r
+///\r
+/// This mode is invoked twice. The first invocation has LegacySegment and\r
+/// LegacyOffset set to 0. The mode returns the table address in EFI memory and its size.\r
+///\r
+/// The second invocation has LegacySegment and LegacyOffset set to the location\r
+/// in the 0xF0000 or 0xE0000 block to which the table is to be copied. The second\r
+/// invocation allows any table address fix ups to occur in the EFI memory copy of the table.\r
+/// The caller, not EfiGetPlatformBinaryOem32Data, copies the modified table to\r
+/// the allocated region in 0xF0000 or 0xE0000 block after the second invocation..\r
+///\r
+/// Note: There are two generic mechanisms by which this mode can be used.\r
+/// Mechanism 1: This mode returns the data and the Legacy BIOS Protocol copies\r
+/// the data into the F0000 or E0000 block in the Compatibility16 code. The\r
+/// EFI_COMPATIBILITY16_TABLE entries Oem32Segment and Oem32Offset can\r
+/// be viewed as two UINT16 entries.\r
+/// Mechanism 2: This mode directly fills in the EFI_COMPATIBILITY16_TABLE with\r
+/// a pointer to the INT15 E820 region containing the 32 bit code. It returns\r
+/// EFI_UNSUPPORTED. The EFI_COMPATIBILITY16_TABLE entries,\r
+/// Oem32Segment and Oem32Offset, can be viewed as two UINT16 entries or\r
+/// as a single UINT32 entry as determined by the IBV.\r
+///\r
+/// The function parameters associated with this mode are:\r
+///\r
+///   TableSize Size of data.\r
+///\r
+///   Location Location to place the table. 0x00 or 0xE0000 or 0xF0000 64 KB blocks.\r
+///       Bit 0 = 1 0xF0000 64 KB block.\r
+///       Bit 1 = 1 0xE0000 64 KB block.\r
+///       Multiple bits can be set.\r
+///\r
+///   Alignment Bit mapped address alignment granularity.\r
+///       The first nonzero bit from the right is the address granularity.\r
+///\r
+///   LegacySegment Segment in which EfiCompatibility code will place the table or data.\r
+///\r
+///   LegacyOffset Offset in which EfiCompatibility code will place the table or data.\r
+///\r
+/// The return values associated with this mode are:\r
+///   EFI_SUCCESS The data was returned successfully.\r
+///   EFI_UNSUPPORTED Oem32 is not supported on this platform.\r
+///\r
+EfiGetPlatformBinaryOem32Data    = 3,\r
+  ///\r
+  /// This mode returns a TPM binary image for the onboard TPM device.\r
+  ///\r
+  /// The function parameters associated with this mode are:\r
+  ///\r
+  ///   Table TPM binary image for the onboard TPM device.\r
+  ///\r
+  ///   TableSize Size of BinaryImage in bytes.\r
+  ///\r
+  ///   Location Location to place the table. 0x00. Either 0xE0000 or 0xF0000 64 KB blocks.\r
+  ///      Bit 0 = 1 0xF0000 64 KB block.\r
+  ///      Bit 1 = 1 0xE0000 64 KB block.\r
+  ///      Multiple bits can be set.\r
+  ///\r
+  ///   Alignment Bit mapped address alignment granularity.\r
+  ///     The first nonzero bit from the right is the address granularity.\r
+  ///\r
+  ///   LegacySegment Segment in which EfiCompatibility code will place the table or data.\r
+  ///\r
+  ///   LegacyOffset Offset in which EfiCompatibility code will place the table or data.\r
+  ///\r
+  /// The return values associated with this mode are:\r
+  ///\r
+  ///   EFI_SUCCESS BinaryImage is valid.\r
+  ///\r
+  ///   EFI_UNSUPPORTED Mode is not supported on this platform.\r
+  ///\r
+  ///   EFI_NOT_FOUND No BinaryImage was found.\r
+  ///\r
   EfiGetPlatformBinaryTpmBinary    = 4,\r
-       ///\r
-       /// The mode finds the Compatibility16 \93ROM\94 image.\r
-       ///\r
-       /// The function parameters associated with this mode are:\r
-       ///\r
-       ///             System ROM image for the platform\r
-       ///\r
-       ///             TableSize Size of Table in bytes\r
-       ///\r
-       ///             Location Ignored\r
-       ///\r
-       ///             Alignment Ignored\r
-       ///\r
-       ///             LegacySegment Ignored\r
-       ///\r
-       ///             LegacyOffset Ignored\r
-       ///\r
-       ///     The return values associated with this mode are:\r
-       ///\r
-       ///             EFI_SUCCESS ROM image found.\r
-       ///\r
-       ///             EFI_NOT_FOUND ROM not found.\r
-       ///\r
+  ///\r
+  /// The mode finds the Compatibility16 Rom Image.\r
+  ///\r
+  /// The function parameters associated with this mode are:\r
+  ///\r
+  ///    System ROM image for the platform.\r
+  ///\r
+  ///    TableSize Size of Table in bytes.\r
+  ///\r
+  ///    Location Ignored.\r
+  ///\r
+  ///    Alignment Ignored.\r
+  ///\r
+  ///    LegacySegment Ignored.\r
+  ///\r
+  ///    LegacyOffset Ignored.\r
+  ///\r
+  /// The return values associated with this mode are:\r
+  ///\r
+  ///    EFI_SUCCESS ROM image found.\r
+  ///\r
+  ///    EFI_NOT_FOUND ROM not found.\r
+  ///\r
   EfiGetPlatformBinarySystemRom    = 5,\r
-       ///\r
-       /// This mode returns the Base address of PciExpress memory mapped configuration\r
-       /// address space.\r
-       ///\r
-       /// The function parameters associated with this mode are:\r
-       ///\r
-       ///             Table System ROM image for the platform\r
-       ///\r
-       ///             TableSize Size of Table in bytes\r
-       ///\r
-       ///             Location Ignored\r
-       ///\r
-       ///             Alignment Ignored\r
-       ///\r
-       ///             LegacySegment Ignored\r
-       ///\r
-       ///             LegacyOffset Ignored\r
-       ///\r
-       ///     The return values associated with this mode are:\r
-       ///\r
-       ///             EFI_SUCCESS Address is valid.\r
-       ///\r
-       ///             EFI_UNSUPPORTED System does not PciExpress.\r
-       ///\r
+  ///\r
+  /// This mode returns the Base address of PciExpress memory mapped configuration\r
+  /// address space.\r
+  ///\r
+  /// The function parameters associated with this mode are:\r
+  ///\r
+  ///    Table System ROM image for the platform.\r
+  ///\r
+  ///    TableSize Size of Table in bytes.\r
+  ///\r
+  ///    Location Ignored.\r
+  ///\r
+  ///    Alignment Ignored.\r
+  ///\r
+  ///    LegacySegment Ignored.\r
+  ///\r
+  ///    LegacyOffset Ignored.\r
+  ///\r
+  /// The return values associated with this mode are:\r
+  ///\r
+  ///   EFI_SUCCESS Address is valid.\r
+  ///\r
+  ///   EFI_UNSUPPORTED System does not PciExpress.\r
+  ///\r
   EfiGetPlatformPciExpressBase     = 6,\r
-       ///\r
+  ///\r
   EfiGetPlatformPmmSize            = 7,\r
-       ///\r
+  ///\r
   EfiGetPlatformEndOpromShadowAddr = 8,\r
-       ///\r
+  ///\r
 } EFI_GET_PLATFORM_INFO_MODE;\r
 \r
 /**\r
-       This enum specifies the Mode param values for GetPlatformHandle()\r
+  This enum specifies the Mode param values for GetPlatformHandle().\r
 **/\r
 typedef enum {\r
-       ///\r
-       /// This mode returns the Compatibility16 policy for the device that should be the VGA\r
-       /// controller used during a Compatibility16 boot.\r
-       ///\r
-       /// The function parameters associated with this mode are:\r
-       ///\r
-       ///             Type 0x00\r
-       ///\r
-       ///             HandleBuffer Buffer of all VGA handles found.\r
-       ///\r
-       ///             HandleCount Number of VGA handles found.\r
-       ///\r
-       ///             AdditionalData NULL\r
-       /// \r
+  ///\r
+  /// This mode returns the Compatibility16 policy for the device that should be the VGA\r
+  /// controller used during a Compatibility16 boot.\r
+  ///\r
+  /// The function parameters associated with this mode are:\r
+  ///\r
+  ///   Type 0x00.\r
+  ///\r
+  ///   HandleBuffer Buffer of all VGA handles found.\r
+  ///\r
+  ///   HandleCount Number of VGA handles found.\r
+  ///\r
+  ///   AdditionalData NULL.\r
+  ///\r
   EfiGetPlatformVgaHandle       = 0,\r
-       ///\r
-       /// This mode returns the Compatibility16 policy for the device that should be the IDE\r
-       /// controller used during a Compatibility16 boot.\r
-       ///\r
-       /// The function parameters associated with this mode are:\r
-       ///\r
-       ///             Type 0x00\r
-       ///\r
-       ///             HandleBuffer Buffer of all IDE handles found.\r
-       ///\r
-       ///             HandleCount Number of IDE handles found\r
-       ///\r
-       ///             AdditionalData Pointer to HddInfo.\r
-       ///                             Information about all onboard IDE controllers.\r
-       ///\r
+  ///\r
+  /// This mode returns the Compatibility16 policy for the device that should be the IDE\r
+  /// controller used during a Compatibility16 boot.\r
+  ///\r
+  /// The function parameters associated with this mode are:\r
+  ///\r
+  ///   Type 0x00.\r
+  ///\r
+  ///   HandleBuffer Buffer of all IDE handles found.\r
+  ///\r
+  ///   HandleCount Number of IDE handles found.\r
+  ///\r
+  ///   AdditionalData Pointer to HddInfo.\r
+  ///     Information about all onboard IDE controllers.\r
+  ///\r
   EfiGetPlatformIdeHandle       = 1,\r
-       ///\r
-       /// This mode returns the Compatibility16 policy for the device that should be the ISA bus\r
-       /// controller used during a Compatibility16 boot.\r
-       ///\r
-       /// The function parameters associated with this mode are:\r
-       ///\r
-       ///             Type 0x00\r
-       ///\r
-       ///             HandleBuffer Buffer of all ISA bus handles found.\r
-       ///\r
-       ///             HandleCount Number of ISA bus handles found.\r
-       ///\r
-       ///             AdditionalData NULL\r
-       ///\r
+  ///\r
+  /// This mode returns the Compatibility16 policy for the device that should be the ISA bus\r
+  /// controller used during a Compatibility16 boot.\r
+  ///\r
+  /// The function parameters associated with this mode are:\r
+  ///\r
+  ///   Type 0x00.\r
+  ///\r
+  ///   HandleBuffer Buffer of all ISA bus handles found.\r
+  ///\r
+  ///   HandleCount Number of ISA bus handles found.\r
+  ///\r
+  ///   AdditionalData NULL.\r
+  ///\r
   EfiGetPlatformIsaBusHandle    = 2,\r
-       ///\r
-       /// This mode returns the Compatibility16 policy for the device that should be the USB\r
-       /// device used during a Compatibility16 boot.\r
-       ///\r
-       /// The function parameters associated with this mode are:\r
-       ///\r
-       ///             Type 0x00\r
-       ///\r
-       ///             HandleBuffer Buffer of all USB handles found.\r
-       ///\r
-       ///             HandleCount Number of USB bus handles found.\r
-       ///\r
-       ///             AdditionalData NULL\r
-       ///\r
+  ///\r
+  /// This mode returns the Compatibility16 policy for the device that should be the USB\r
+  /// device used during a Compatibility16 boot.\r
+  ///\r
+  /// The function parameters associated with this mode are:\r
+  ///\r
+  ///   Type 0x00.\r
+  ///\r
+  ///   HandleBuffer Buffer of all USB handles found.\r
+  ///\r
+  ///   HandleCount Number of USB bus handles found.\r
+  ///\r
+  ///   AdditionalData NULL.\r
+  ///\r
   EfiGetPlatformUsbHandle       = 3\r
 } EFI_GET_PLATFORM_HANDLE_MODE;\r
 \r
 /**\r
-       This enum specifies the Mode param values for PlatformHooks()\r
-       Note: Any OEM defined hooks start with 0x8000\r
+  This enum specifies the Mode param values for PlatformHooks().\r
+  Note: Any OEM defined hooks start with 0x8000.\r
 **/\r
 typedef enum {\r
-       ///\r
-       /// This mode allows any preprocessing before scanning OpROMs.\r
-       ///\r
-       /// The function parameters associated with this mode are:\r
-       ///\r
-       ///                     Type 0\r
-       ///\r
-       ///                     DeviceHandle Handle of device OpROM is associated with. \r
-       ///\r
-       ///                     ShadowAddress Address where OpROM is shadowed.\r
-       ///\r
-       ///                     Compatibility16Table NULL\r
-       ///\r
-       ///                     AdditionalData NULL\r
-       ///\r
+  ///\r
+  /// This mode allows any preprocessing before scanning OpROMs.\r
+  ///\r
+  /// The function parameters associated with this mode are:\r
+  ///\r
+  ///     Type 0.\r
+  ///\r
+  ///     DeviceHandle Handle of device OpROM is associated with.\r
+  ///\r
+  ///     ShadowAddress Address where OpROM is shadowed.\r
+  ///\r
+  ///     Compatibility16Table NULL.\r
+  ///\r
+  ///     AdditionalData NULL.\r
+  ///\r
   EfiPlatformHookPrepareToScanRom = 0,\r
-       ///\r
-       /// This mode shadows legacy OpROMS that may not have a physical device associated with\r
-       /// them. It returns EFI_SUCCESS if the ROM was shadowed.\r
-       ///\r
-       /// The function parameters associated with this mode are:\r
-       ///\r
-       ///             Type 0\r
-       ///\r
-       ///                     DeviceHandle 0\r
-       ///\r
-       ///                     ShadowAddress   First free OpROM area, after other OpROMs have been dispatched..\r
-       ///\r
-       ///                     Compatibility16Table Pointer to the Compatability16 Table.\r
-       ///\r
-       ///                     AdditionalData NULL\r
-       ///\r
+  ///\r
+  /// This mode shadows legacy OpROMS that may not have a physical device associated with\r
+  /// them. It returns EFI_SUCCESS if the ROM was shadowed.\r
+  ///\r
+  /// The function parameters associated with this mode are:\r
+  ///\r
+  ///     Type 0.\r
+  ///\r
+  ///     DeviceHandle 0.\r
+  ///\r
+  ///     ShadowAddress First free OpROM area, after other OpROMs have been dispatched..\r
+  ///\r
+  ///     Compatibility16Table Pointer to the Compatability16 Table.\r
+  ///\r
+  ///       AdditionalData NULL.\r
+  ///\r
   EfiPlatformHookShadowServiceRoms= 1,\r
-       ///\r
-       /// This mode allows platform to perform any required operation after an OpROM has\r
-       /// completed its initialization.\r
-       ///\r
-       /// The function parameters associated with this mode are:\r
-       ///\r
-       ///                     Type 0\r
-       ///\r
-       ///                     DeviceHandle Handle of device OpROM is associated with. \r
-       ///\r
-       ///                     ShadowAddress Address where OpROM is shadowed.\r
-       ///\r
-       ///                     Compatibility16Table NULL\r
-       ///\r
-       ///                     AdditionalData NULL\r
-       /// \r
+  ///\r
+  /// This mode allows platform to perform any required operation after an OpROM has\r
+  /// completed its initialization.\r
+  ///\r
+  /// The function parameters associated with this mode are:\r
+  ///\r
+  ///       Type 0.\r
+  ///\r
+  ///       DeviceHandle Handle of device OpROM is associated with.\r
+  ///\r
+  ///       ShadowAddress Address where OpROM is shadowed.\r
+  ///\r
+  ///       Compatibility16Table NULL.\r
+  ///\r
+  ///       AdditionalData NULL.\r
+  ///\r
   EfiPlatformHookAfterRomInit     = 2\r
 } EFI_GET_PLATFORM_HOOK_MODE;\r
 \r
-\r
-//\r
-//\r
-//\r
-\r
 ///\r
 /// This IRQ has not been assigned to PCI.\r
 ///\r
 #define PCI_UNUSED        0x00\r
 ///\r
 /// This IRQ has been assigned to PCI.\r
-/// \r
+///\r
 #define PCI_USED          0xFF\r
 ///\r
 /// This IRQ has been used by an SIO legacy device and cannot be used by PCI.\r
 ///\r
+#define LEGACY_USED       0xFE\r
+\r
 #pragma pack(1)\r
 \r
-//\r
-//\r
-//\r
 typedef struct {\r
-       ///\r
-       /// IRQ for this entry.\r
-       ///\r
+  ///\r
+  /// IRQ for this entry.\r
+  ///\r
   UINT8 Irq;\r
-       ///\r
-       /// Status of this IRQ.\r
-       ///\r
-       /// PCI_UNUSED 0x00. This IRQ has not been assigned to PCI.\r
-       ///\r
-       /// PCI_USED 0xFF. This IRQ has been assigned to PCI.\r
-       ///\r
-       /// LEGACY_USED 0xFE. This IRQ has been used by an SIO legacy\r
-       /// device and cannot be used by PCI.\r
-       ///\r
+  ///\r
+  /// Status of this IRQ.\r
+  ///\r
+  /// PCI_UNUSED 0x00. This IRQ has not been assigned to PCI.\r
+  ///\r
+  /// PCI_USED 0xFF. This IRQ has been assigned to PCI.\r
+  ///\r
+  /// LEGACY_USED 0xFE. This IRQ has been used by an SIO legacy\r
+  /// device and cannot be used by PCI.\r
+  ///\r
   UINT8 Used;\r
 } EFI_LEGACY_IRQ_PRIORITY_TABLE_ENTRY;\r
 \r
@@ -452,95 +446,88 @@ typedef struct {
 #define EFI_LEGACY_PIRQ_TABLE_SIGNATURE SIGNATURE_32 ('$', 'P', 'I', 'R')\r
 \r
 typedef struct {\r
-       ///\r
-       /// $PIR.\r
-       ///\r
+  ///\r
+  /// $PIR.\r
+  ///\r
   UINT32  Signature;\r
-       ///\r
-       /// 0x00.\r
-       ///\r
+  ///\r
+  /// 0x00.\r
+  ///\r
   UINT8   MinorVersion;\r
-       ///\r
-       /// 0x01 for table version 1.0.\r
-       ///\r
+  ///\r
+  /// 0x01 for table version 1.0.\r
+  ///\r
   UINT8   MajorVersion;\r
-       ///\r
-       /// 0x20 + RoutingTableEntries * 0x10.\r
-       ///\r
+  ///\r
+  /// 0x20 + RoutingTableEntries * 0x10.\r
+  ///\r
   UINT16  TableSize;\r
-       ///\r
-       /// PCI interrupt router bus.\r
-       ///\r
+  ///\r
+  /// PCI interrupt router bus.\r
+  ///\r
   UINT8   Bus;\r
-       ///\r
-       /// PCI interrupt router device/function.\r
-       ///\r
+  ///\r
+  /// PCI interrupt router device/function.\r
+  ///\r
   UINT8   DevFun;\r
-       ///\r
-       /// If nonzero, bit map of IRQs reserved for PCI.\r
-       ///\r
+  ///\r
+  /// If nonzero, bit map of IRQs reserved for PCI.\r
+  ///\r
   UINT16  PciOnlyIrq;\r
-       ///\r
-       /// Vendor ID of a compatible PCI interrupt router.\r
-       ///\r
+  ///\r
+  /// Vendor ID of a compatible PCI interrupt router.\r
+  ///\r
   UINT16  CompatibleVid;\r
-       ///\r
-       /// Device ID of a compatible PCI interrupt router.\r
-       ///\r
+  ///\r
+  /// Device ID of a compatible PCI interrupt router.\r
+  ///\r
   UINT16  CompatibleDid;\r
-       ///\r
-       /// If nonzero, a value passed directly to the IRQ miniport\92s Initialize function.\r
+  ///\r
+  /// If nonzero, a value passed directly to the IRQ miniport's Initialize function.\r
   ///\r
   UINT32  Miniport;\r
-       ///\r
-       /// Reserved for future usage.\r
-       ///\r
+  ///\r
+  /// Reserved for future usage.\r
+  ///\r
   UINT8   Reserved[11];\r
-       ///\r
-       /// This byte plus the sum of all other bytes in the LocalPirqTable equal 0x00.\r
-       ///\r
+  ///\r
+  /// This byte plus the sum of all other bytes in the LocalPirqTable equal 0x00.\r
+  ///\r
   UINT8   Checksum;\r
 } EFI_LEGACY_PIRQ_TABLE_HEADER;\r
 \r
 \r
 typedef struct {\r
-       ///\r
-       /// IRQ for this entry.\r
-       ///\r
+  ///\r
+  /// If nonzero, a value assigned by the IBV.\r
+  ///\r
   UINT8   Pirq;\r
-       ///\r
-       /// Status of this IRQ.\r
-       ///\r
-       ///             PCI_UNUSED 0x00. This IRQ has not been assigned to PCI.\r
-       ///\r
-       ///             PCI_USED 0xFF. This IRQ has been assigned to PCI.\r
-       ///\r
-       ///             LEGACY_USED 0xFE. This IRQ has been used by an SIO legacy\r
-       ///                             device and cannot be used by PCI.\r
-       ///\r
+  ///\r
+  /// If nonzero, the IRQs that can be assigned to this device.\r
+  ///\r
   UINT16  IrqMask;\r
 } EFI_LEGACY_PIRQ_ENTRY;\r
 \r
 typedef struct {\r
-       ///\r
-       /// PCI bus of the entry.\r
-       ///\r
+  ///\r
+  /// PCI bus of the entry.\r
+  ///\r
   UINT8                 Bus;\r
-       ///\r
-       /// PCI device of this entry.\r
-       ///\r
+  ///\r
+  /// PCI device of this entry.\r
+  ///\r
   UINT8                 Device;\r
-       ///\r
-       /// An IBV value and IRQ mask for PIRQ pins A through D.\r
-       ///\r
+  ///\r
+  /// An IBV value and IRQ mask for PIRQ pins A through D.\r
+  ///\r
   EFI_LEGACY_PIRQ_ENTRY PirqEntry[4];\r
-       ///\r
-       /// If nonzero, the slot number assigned by the board manufacturer.\r
-       ///\r
+  ///\r
+  /// If nonzero, the slot number assigned by the board manufacturer.\r
+  ///\r
   UINT8                 Slot;\r
-       ///\r
-       /// Reserved for future use.\r
-       ///\r
+  ///\r
+  /// Reserved for future use.\r
+  ///\r
   UINT8                 Reserved;\r
 } EFI_LEGACY_IRQ_ROUTING_ENTRY;\r
 \r
@@ -550,16 +537,16 @@ typedef struct {
 /**\r
   Finds the binary data or other platform information.\r
 \r
-  @param  This                  Protocol instance pointer.\r
+  @param  This                  The protocol instance pointer.\r
   @param  Mode                  Specifies what data to return. See See EFI_GET_PLATFORM_INFO_MODE enum.\r
   @param  Table                 Mode specific.  See EFI_GET_PLATFORM_INFO_MODE enum.\r
-  @param  TableSize            Mode specific.  See EFI_GET_PLATFORM_INFO_MODE enum.\r
-  @param  Location             Mode specific.  See EFI_GET_PLATFORM_INFO_MODE enum.\r
+  @param  TableSize              Mode specific.  See EFI_GET_PLATFORM_INFO_MODE enum.\r
+  @param  Location               Mode specific.  See EFI_GET_PLATFORM_INFO_MODE enum.\r
   @param  Alignment             Mode specific.  See EFI_GET_PLATFORM_INFO_MODE enum.\r
   @param  LegacySegment         Mode specific.  See EFI_GET_PLATFORM_INFO_MODE enum.\r
-  @param  LegacyOffset                 Mode specific.  See EFI_GET_PLATFORM_INFO_MODE enum.\r
+  @param  LegacyOffset          Mode specific.  See EFI_GET_PLATFORM_INFO_MODE enum.\r
 \r
-  @retval EFI_SUCCESS           Data was returned successfully.\r
+  @retval EFI_SUCCESS           Data returned successfully.\r
   @retval EFI_UNSUPPORTED       Mode is not supported on the platform.\r
   @retval EFI_NOT_FOUND         Binary image or table not found.\r
 \r
@@ -580,16 +567,16 @@ EFI_STATUS
 /**\r
   Returns a buffer of handles for the requested subfunction.\r
 \r
-  @param  This                         Protocol instance pointer.\r
+  @param  This                  The protocol instance pointer.\r
   @param  Mode                  Specifies what handle to return. See EFI_GET_PLATFORM_HANDLE_MODE enum.\r
-  @param  Type                   Mode specific. See EFI_GET_PLATFORM_HANDLE_MODE enum.\r
+  @param  Type                  Mode specific. See EFI_GET_PLATFORM_HANDLE_MODE enum.\r
   @param  HandleBuffer          Mode specific. See EFI_GET_PLATFORM_HANDLE_MODE enum.\r
   @param  HandleCount           Mode specific. See EFI_GET_PLATFORM_HANDLE_MODE enum.\r
   @param  AdditionalData        Mode specific. See EFI_GET_PLATFORM_HANDLE_MODE enum.\r
 \r
-  @retval EFI_SUCCESS           Handle is valid\r
+  @retval EFI_SUCCESS           Handle is valid.\r
   @retval EFI_UNSUPPORTED       Mode is not supported on the platform.\r
-  @retval EFI_NOT_FOUND         Handle is not known\r
+  @retval EFI_NOT_FOUND         Handle is not known.\r
 \r
 **/\r
 typedef\r
@@ -606,8 +593,8 @@ EFI_STATUS
 /**\r
   Load and initialize the Legacy BIOS SMM handler.\r
 \r
-  @param  This                   Protocol instance pointer.\r
-  @param  EfiToLegacy16BootTable Pointer to Legacy16 boot table.\r
+  @param  This                   The protocol instance pointer.\r
+  @param  EfiToLegacy16BootTable A pointer to Legacy16 boot table.\r
 \r
   @retval EFI_SUCCESS           SMM code loaded.\r
   @retval EFI_DEVICE_ERROR      SMM code failed to load\r
@@ -622,9 +609,9 @@ EFI_STATUS
 \r
 /**\r
   Allows platform to perform any required action after a LegacyBios operation.\r
-       Invokes the specific sub function specified by Mode.\r
+  Invokes the specific sub function specified by Mode.\r
 \r
-  @param  This                  Protocol instance pointer.\r
+  @param  This                  The protocol instance pointer.\r
   @param  Mode                  Specifies what handle to return. See EFI_GET_PLATFORM_HOOK_MODE enum.\r
   @param  Type                  Mode specific.  See EFI_GET_PLATFORM_HOOK_MODE enum.\r
   @param  DeviceHandle          Mode specific.  See EFI_GET_PLATFORM_HOOK_MODE enum.\r
@@ -632,7 +619,7 @@ EFI_STATUS
   @param  Compatibility16Table  Mode specific.  See EFI_GET_PLATFORM_HOOK_MODE enum.\r
   @param  AdditionalData        Mode specific.  See EFI_GET_PLATFORM_HOOK_MODE enum.\r
 \r
-  @retval EFI_SUCCESS           The operation performed successfully, Mode specific.\r
+  @retval EFI_SUCCESS           The operation performed successfully. Mode specific.\r
   @retval EFI_UNSUPPORTED       Mode is not supported on the platform.\r
 \r
 **/\r
@@ -650,19 +637,19 @@ EFI_STATUS
 \r
 /**\r
   Returns information associated with PCI IRQ routing.\r
-       This function returns the following information associated with PCI IRQ routing:\r
-               An IRQ routing table and number of entries in the table\r
-               The $PIR table and its size\r
-               A list of PCI IRQs and the priority order to assign them\r
-\r
-  @param  This                    Protocol instance pointer.\r
-  @param  RoutingTable            Pointer to PCI IRQ Routing table. \r
-                                                                                                               This location is the $PIR table minus the header.\r
-  @param  RoutingTableEntries     Number of entries in table.\r
-  @param  LocalPirqTable          $PIR table\r
-  @param  PirqTableSize           $PIR table size\r
-  @param  LocalIrqPriorityTable   List of interrupts in priority order to assign\r
-  @param  IrqPriorityTableEntries Number of entries in priority table\r
+  This function returns the following information associated with PCI IRQ routing:\r
+    * An IRQ routing table and number of entries in the table.\r
+    * The $PIR table and its size.\r
+    * A list of PCI IRQs and the priority order to assign them.\r
+\r
+  @param  This                    The protocol instance pointer.\r
+  @param  RoutingTable            The pointer to PCI IRQ Routing table.\r
+                                  This location is the $PIR table minus the header.\r
+  @param  RoutingTableEntries     The number of entries in table.\r
+  @param  LocalPirqTable          $PIR table.\r
+  @param  PirqTableSize           $PIR table size.\r
+  @param  LocalIrqPriorityTable   A list of interrupts in priority order to assign.\r
+  @param  IrqPriorityTableEntries The number of entries in the priority table.\r
 \r
   @retval EFI_SUCCESS           Data was successfully returned.\r
 \r
@@ -680,16 +667,16 @@ EFI_STATUS
   );\r
 \r
 /**\r
-  Translates the given PIRQ accounting for bridge\r
-       This function translates the given PIRQ back through all buses, if required, \r
-       and returns the true PIRQ and associated IRQ.\r
-\r
-  @param  This                  Protocol instance pointer.\r
-  @param  PciBus                PCI bus number for this device.\r
-  @param  PciDevice             PCI device number for this device.\r
-  @param  PciFunction           PCI function number for this device.\r
-  @param  Pirq                  Input is PIRQ reported by device, output is true PIRQ.\r
-  @param  PciIrq                The IRQ already assigned to the PIRQ or the IRQ to be\r
+  Translates the given PIRQ accounting for bridge.\r
+  This function translates the given PIRQ back through all buses, if required,\r
+  and returns the true PIRQ and associated IRQ.\r
+\r
+  @param  This                  The protocol instance pointer.\r
+  @param  PciBus                The PCI bus number for this device.\r
+  @param  PciDevice             The PCI device number for this device.\r
+  @param  PciFunction           The PCI function number for this device.\r
+  @param  Pirq                  Input is PIRQ reported by device, and output is true PIRQ.\r
+  @param  PciIrq                The IRQ already assigned to the PIRQ, or the IRQ to be\r
                                 assigned to the PIRQ.\r
 \r
   @retval EFI_SUCCESS           The PIRQ was translated.\r
@@ -710,12 +697,12 @@ EFI_STATUS
   Attempt to legacy boot the BootOption. If the EFI contexted has been\r
   compromised this function will not return.\r
 \r
-  @param  This                   Protocol instance pointer.\r
-  @param  BbsDevicePath          EFI Device Path from BootXXXX variable.\r
-  @param  BbsTable               Internal BBS table.\r
-  @param  LoadOptionSize         Size of LoadOption in size.\r
-  @param  LoadOption             LoadOption from BootXXXX variable\r
-  @param  EfiToLegacy16BootTable Pointer to BootTable structure\r
+  @param  This                   The protocol instance pointer.\r
+  @param  BbsDevicePath          The EFI Device Path from BootXXXX variable.\r
+  @param  BbsTable               The Internal BBS table.\r
+  @param  LoadOptionSize         The size of LoadOption in size.\r
+  @param  LoadOption             The LoadOption from BootXXXX variable\r
+  @param  EfiToLegacy16BootTable A pointer to BootTable structure\r
 \r
   @retval EFI_SUCCESS           Ready to boot.\r
 \r
@@ -735,32 +722,32 @@ EFI_STATUS
   This protocol abstracts the platform portion of the traditional BIOS.\r
 **/\r
 struct _EFI_LEGACY_BIOS_PLATFORM_PROTOCOL {\r
-       ///\r
-  /// Gets binary data or other platform information.\r
-       ///\r
-  EFI_LEGACY_BIOS_PLATFORM_GET_PLATFORM_INFO                   GetPlatformInfo;\r
-       ///\r
-       ///  Returns a buffer of all handles matching the requested subfunction.\r
-       ///\r
+  ///\r
+  ///  Gets binary data or other platform information.\r
+  ///\r
+  EFI_LEGACY_BIOS_PLATFORM_GET_PLATFORM_INFO    GetPlatformInfo;\r
+  ///\r
+  ///  Returns a buffer of all handles matching the requested subfunction.\r
+  ///\r
   EFI_LEGACY_BIOS_PLATFORM_GET_PLATFORM_HANDLE  GetPlatformHandle;\r
-       ///\r
-       ///  Loads and initializes the traditional BIOS SMM handler.\r
-  EFI_LEGACY_BIOS_PLATFORM_SMM_INIT                                                            SmmInit;\r
-       ///\r
-       ///   Allows platform to perform any required actions after a LegacyBios operation.\r
-       ///\r
-  EFI_LEGACY_BIOS_PLATFORM_HOOKS                                                               PlatformHooks;\r
-       ///\r
-       ///       Gets $PIR table.\r
-  EFI_LEGACY_BIOS_PLATFORM_GET_ROUTING_TABLE                   GetRoutingTable;\r
-       /// \r
-       ///       Translates the given PIRQ to the final value after traversing any PCI bridges.\r
-       ///\r
-  EFI_LEGACY_BIOS_PLATFORM_TRANSLATE_PIRQ                              TranslatePirq;\r
-       ///\r
-       ///       Final platform function before the system attempts to boot to a traditional OS.\r
-       ///\r
-  EFI_LEGACY_BIOS_PLATFORM_PREPARE_TO_BOOT                     PrepareToBoot;\r
+  ///\r
+  ///  Loads and initializes the traditional BIOS SMM handler.\r
+  EFI_LEGACY_BIOS_PLATFORM_SMM_INIT             SmmInit;\r
+  ///\r
+  ///  Allows platform to perform any required actions after a LegacyBios operation.\r
+  ///\r
+  EFI_LEGACY_BIOS_PLATFORM_HOOKS                PlatformHooks;\r
+  ///\r
+  ///  Gets $PIR table.\r
+  EFI_LEGACY_BIOS_PLATFORM_GET_ROUTING_TABLE    GetRoutingTable;\r
+  ///\r
+  ///  Translates the given PIRQ to the final value after traversing any PCI bridges.\r
+  ///\r
+  EFI_LEGACY_BIOS_PLATFORM_TRANSLATE_PIRQ       TranslatePirq;\r
+  ///\r
+  ///  Final platform function before the system attempts to boot to a traditional OS.\r
+  ///\r
+  EFI_LEGACY_BIOS_PLATFORM_PREPARE_TO_BOOT      PrepareToBoot;\r
 };\r
 \r
 extern EFI_GUID gEfiLegacyBiosPlatformProtocolGuid;\r