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, 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 - 2011, Intel Corporation. All rights reserved.<BR>\r
+This program and the accompanying materials are licensed and made available under \r
+the terms and conditions of the BSD License that accompanies this distribution. \r
+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
@par Revision Reference:\r
This protocol is defined in Framework for EFI Compatibility Support Module spec\r
- Version 0.96\r
+ Version 0.97.\r
\r
**/\r
\r
#ifndef _EFI_LEGACY_BIOS_PLATFORM_H_\r
#define _EFI_LEGACY_BIOS_PLATFORM_H_\r
\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
0x783658a3, 0x4172, 0x4421, {0xa2, 0x99, 0xe0, 0x9, 0x7, 0x9c, 0xc, 0xb4 } \\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
+**/\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, 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 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 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
- EfiGetPlatformBinaryOem32Data = 3,\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 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
EfiGetPlatformPciExpressBase = 6,\r
+ ///\r
EfiGetPlatformPmmSize = 7,\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
+**/\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
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
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
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
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
+**/\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
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
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
EfiPlatformHookAfterRomInit = 2\r
} EFI_GET_PLATFORM_HOOK_MODE;\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
+#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
+typedef struct {\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
+ UINT8 Used;\r
+} EFI_LEGACY_IRQ_PRIORITY_TABLE_ENTRY;\r
+\r
+//\r
+// Define PIR table structures\r
+//\r
+#define EFI_LEGACY_PIRQ_TABLE_SIGNATURE SIGNATURE_32 ('$', 'P', 'I', 'R')\r
+\r
+typedef struct {\r
+ ///\r
+ /// $PIR.\r
+ ///\r
+ UINT32 Signature;\r
+ ///\r
+ /// 0x00.\r
+ ///\r
+ UINT8 MinorVersion;\r
+ ///\r
+ /// 0x01 for table version 1.0.\r
+ ///\r
+ UINT8 MajorVersion;\r
+ ///\r
+ /// 0x20 + RoutingTableEntries * 0x10.\r
+ ///\r
+ UINT16 TableSize;\r
+ ///\r
+ /// PCI interrupt router bus.\r
+ ///\r
+ UINT8 Bus;\r
+ ///\r
+ /// PCI interrupt router device/function.\r
+ ///\r
+ UINT8 DevFun;\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
+ UINT16 CompatibleVid;\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's Initialize function.\r
+ ///\r
+ UINT32 Miniport;\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
+ UINT8 Checksum;\r
+} EFI_LEGACY_PIRQ_TABLE_HEADER;\r
+\r
+\r
+typedef struct {\r
+ ///\r
+ /// If nonzero, a value assigned by the IBV.\r
+ ///\r
+ UINT8 Pirq;\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
+ UINT8 Bus;\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
+ EFI_LEGACY_PIRQ_ENTRY PirqEntry[4];\r
+ ///\r
+ /// If nonzero, the slot number assigned by the board manufacturer.\r
+ ///\r
+ UINT8 Slot;\r
+ ///\r
+ /// Reserved for future use.\r
+ ///\r
+ UINT8 Reserved;\r
+} EFI_LEGACY_IRQ_ROUTING_ENTRY;\r
+\r
+#pragma pack()\r
+\r
+\r
/**\r
Finds the binary data or other platform information.\r
\r
- @param This Protocol instance pointer.\r
- @param Mode Specifies what data to return\r
- @param Table Pointer to MP table.\r
- @param TableSize Size in bytes of table.\r
- @param Location Legacy region requested\r
- 0x00 = Any location\r
- Bit 0 = 0xF0000 region\r
- Bit 1 = 0xE0000 region\r
- Multiple bits can be set\r
- @param Alignment Address alignment for allocation.\r
- Bit mapped. First non-zero bit from right\r
- is alignment.\r
- @param LegacySegment Segment in LegacyBios where Table is stored\r
- @param LegacyOffset Offset in LegacyBios where Table is stored\r
-\r
- @retval EFI_SUCCESS Data was returned successfully.\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 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
+\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
**/\r
typedef\r
EFI_STATUS\r
-(EFIAPI *EFI_LEGACY_BIOS_PLATFORM_GET_PLATFORM_INFO) (\r
+(EFIAPI *EFI_LEGACY_BIOS_PLATFORM_GET_PLATFORM_INFO)(\r
IN EFI_LEGACY_BIOS_PLATFORM_PROTOCOL *This,\r
IN EFI_GET_PLATFORM_INFO_MODE Mode,\r
OUT VOID **Table,\r
);\r
\r
/**\r
- Returns a buffer of handles for the requested sub-function.\r
+ Returns a buffer of handles for the requested subfunction.\r
\r
- @param This Protocol instance pointer.\r
- @param Mode Specifies what handle to return.\r
- @param Type Type from Device Path for Handle to represent.\r
- @param HandleBuffer Handles of the device/controller in priority order\r
- with HandleBuffer[0] highest priority.\r
- @param HandleCount Number of handles in the buffer.\r
- @param AdditionalData Mode specific.\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 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
EFI_STATUS\r
-(EFIAPI *EFI_LEGACY_BIOS_PLATFORM_GET_PLATFORM_HANDLE) (\r
+(EFIAPI *EFI_LEGACY_BIOS_PLATFORM_GET_PLATFORM_HANDLE)(\r
IN EFI_LEGACY_BIOS_PLATFORM_PROTOCOL *This,\r
IN EFI_GET_PLATFORM_HANDLE_MODE Mode,\r
IN UINT16 Type,\r
/**\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
**/\r
typedef\r
EFI_STATUS\r
-(EFIAPI *EFI_LEGACY_BIOS_PLATFORM_SMM_INIT) (\r
+(EFIAPI *EFI_LEGACY_BIOS_PLATFORM_SMM_INIT)(\r
IN EFI_LEGACY_BIOS_PLATFORM_PROTOCOL *This,\r
IN VOID *EfiToLegacy16BootTable\r
);\r
\r
/**\r
Allows platform to perform any required action after a LegacyBios operation.\r
+ Invokes the specific sub function specified by Mode.\r
\r
- @param This Protocol instance pointer.\r
- @param Mode Specifies what handle to return.\r
- @param Type Mode specific.\r
- @param DeviceHandle List of PCI devices in the system.\r
- @param ShadowAddress First free OpROM area, after other OpROMs have been dispatched.\r
- @param Compatibility16Table Pointer to Compatibility16Table.\r
- @param AdditionalData Mode specific Pointer to additional data returned - mode specific.\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
+ @param ShadowAddress Mode specific. See EFI_GET_PLATFORM_HOOK_MODE enum.\r
+ @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 RomImage is valid\r
+ @retval EFI_SUCCESS The operation performed successfully. Mode specific.\r
@retval EFI_UNSUPPORTED Mode is not supported on the platform.\r
\r
**/\r
typedef\r
EFI_STATUS\r
-(EFIAPI *EFI_LEGACY_BIOS_PLATFORM_HOOKS) (\r
+(EFIAPI *EFI_LEGACY_BIOS_PLATFORM_HOOKS)(\r
IN EFI_LEGACY_BIOS_PLATFORM_PROTOCOL *This,\r
IN EFI_GET_PLATFORM_HOOK_MODE Mode,\r
IN UINT16 Type,\r
- IN EFI_HANDLE DeviceHandle,\r
- IN OUT UINTN *ShadowAddress,\r
- IN EFI_COMPATIBILITY16_TABLE *Compatibility16Table,\r
- IN VOID **AdditionalData OPTIONAL\r
+ IN EFI_HANDLE DeviceHandle, OPTIONAL\r
+ IN OUT UINTN *ShadowAddress, OPTIONAL\r
+ IN EFI_COMPATIBILITY16_TABLE *Compatibility16Table, OPTIONAL\r
+ OUT VOID **AdditionalData OPTIONAL\r
);\r
\r
/**\r
Returns information associated with PCI IRQ routing.\r
-\r
- @param This Protocol instance pointer.\r
- @param RoutingTable Pointer to PCI IRQ Routing table.\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
**/\r
typedef\r
EFI_STATUS\r
-(EFIAPI *EFI_LEGACY_BIOS_PLATFORM_GET_ROUTING_TABLE) (\r
+(EFIAPI *EFI_LEGACY_BIOS_PLATFORM_GET_ROUTING_TABLE)(\r
IN EFI_LEGACY_BIOS_PLATFORM_PROTOCOL *This,\r
OUT VOID **RoutingTable,\r
OUT UINTN *RoutingTableEntries,\r
);\r
\r
/**\r
- Translates the given PIRQ accounting for bridge\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
**/\r
typedef\r
EFI_STATUS\r
-(EFIAPI *EFI_LEGACY_BIOS_PLATFORM_TRANSLATE_PIRQ) (\r
+(EFIAPI *EFI_LEGACY_BIOS_PLATFORM_TRANSLATE_PIRQ)(\r
IN EFI_LEGACY_BIOS_PLATFORM_PROTOCOL *This,\r
IN UINTN PciBus,\r
IN UINTN PciDevice,\r
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
**/\r
typedef\r
EFI_STATUS\r
-(EFIAPI *EFI_LEGACY_BIOS_PLATFORM_PREPARE_TO_BOOT) (\r
+(EFIAPI *EFI_LEGACY_BIOS_PLATFORM_PREPARE_TO_BOOT)(\r
IN EFI_LEGACY_BIOS_PLATFORM_PROTOCOL *This,\r
IN BBS_BBS_DEVICE_PATH *BbsDevicePath,\r
IN VOID *BbsTable,\r
);\r
\r
/**\r
- @par Protocol Description:\r
- Abstracts the platform portion of the traditional BIOS.\r
-\r
- @param GetPlatformInfo\r
- Gets binary data or other platform information.\r
-\r
- @param GetPlatformHandle\r
- Returns a buffer of all handles matching the requested subfunction.\r
-\r
- @param SmmInit\r
- Loads and initializes the traditional BIOS SMM handler.\r
-\r
- @param PlatformHooks\r
- Allows platform to perform any required actions after a LegacyBios operation.\r
-\r
- @param GetRoutingTable\r
- Gets $PIR table.\r
-\r
- @param TranslatePirq\r
- Translates the given PIRQ to the final value after traversing any PCI bridges.\r
-\r
- @param PrepareToBoot\r
- Final platform function before the system attempts to boot to a traditional OS.\r
-\r
+ 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
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
\r