X-Git-Url: https://git.proxmox.com/?a=blobdiff_plain;f=MdePkg%2FInclude%2FProtocol%2FPciPlatform.h;h=15d735e1fe7ed3b21ffeece8597544176d91b51c;hb=3e2c7843022d849971a539387a4ad8b9862dadfb;hp=123309b8b18655e755ca0c3f07d5645a08217f40;hpb=73c31a3d5e7a2c401f839cf5eea82c39d4a08ec4;p=mirror_edk2.git
diff --git a/MdePkg/Include/Protocol/PciPlatform.h b/MdePkg/Include/Protocol/PciPlatform.h
index 123309b8b1..15d735e1fe 100644
--- a/MdePkg/Include/Protocol/PciPlatform.h
+++ b/MdePkg/Include/Protocol/PciPlatform.h
@@ -1,17 +1,17 @@
/** @file
- This file declares PlatfromOpRom protocols which provides the interface between
+ This file declares PlatfromOpRom protocols that provide the interface between
the PCI bus driver/PCI Host Bridge Resource Allocation driver and a platform-specific
- driver to describe the unique features of a platform. This
- protocol is optional.
+ driver to describe the unique features of a platform.
+ This protocol is optional.
- Copyright (c) 2007 - 2009, Intel Corporation
- All rights reserved. This program and the accompanying materials
- are licensed and made available under the terms and conditions of the BSD License
- which accompanies this distribution. The full text of the license may be found at
- http://opensource.org/licenses/bsd-license.php
-
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+Copyright (c) 2007 - 2010, Intel Corporation. All rights reserved.
+This program and the accompanying materials are licensed and made available under
+the terms and conditions of the BSD License that accompanies this distribution.
+The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php.
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
@par Revision Reference:
This Protocol is defined in UEFI Platform Initialization Specification 1.2
@@ -24,12 +24,12 @@
///
/// This file must be included because the EFI_PCI_PLATFORM_PROTOCOL uses
-/// EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE
+/// EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE.
///
#include
///
-/// Global ID for the EFI_PCI_PLATFORM_PROTOCOL
+/// Global ID for the EFI_PCI_PLATFORM_PROTOCOL.
///
#define EFI_PCI_PLATFORM_PROTOCOL_GUID \
{ \
@@ -37,12 +37,12 @@
}
///
-/// Forward declaration for EFI_PCI_PLATFORM_PROTOCOL
+/// Forward declaration for EFI_PCI_PLATFORM_PROTOCOL.
///
typedef struct _EFI_PCI_PLATFORM_PROTOCOL EFI_PCI_PLATFORM_PROTOCOL;
///
-/// EFI_PCI_PLATYFORM_POLICY that is a bitmask with the following legal combinations:
+/// EFI_PCI_PLATFORM_POLICY that is a bitmask with the following legal combinations:
/// - EFI_RESERVE_NONE_IO_ALIAS:
/// Does not set aside either ISA or VGA I/O resources during PCI
/// enumeration. By using this selection, the platform indicates that it does
@@ -52,7 +52,7 @@ typedef struct _EFI_PCI_PLATFORM_PROTOCOL EFI_PCI_PLATFORM_PROTOCOL;
/// - EFI_RESERVE_ISA_IO_ALIAS | EFI_RESERVE_VGA_IO_ALIAS:
/// Sets aside the ISA I/O range and all the aliases during PCI
/// enumeration. VGA I/O ranges and aliases are included in ISA alias
-/// ranges. In this scheme, 75 percent of the I/O space remains unused.
+/// ranges. In this scheme, seventy-five percent of the I/O space remains unused.
/// By using this selection, the platform indicates that it wants to support
/// PCI devices that require the following, at the cost of wasted I/O space:
/// ISA range and its aliases
@@ -70,15 +70,15 @@ typedef struct _EFI_PCI_PLATFORM_PROTOCOL EFI_PCI_PLATFORM_PROTOCOL;
/// The first device that requests the legacy VGA range will get all the
/// legacy VGA range plus its aliased addresses forwarded to it. The first
/// device that requests the legacy ISA range will get all the legacy ISA
-/// range plus its aliased addresses forwarded to it.
+/// range, plus its aliased addresses, forwarded to it.
/// - EFI_RESERVE_ISA_IO_NO_ALIAS | EFI_RESERVE_VGA_IO_ALIAS:
-/// Sets aside the ISA I/O range (0x1000x3FF) during PCI enumeration
+/// Sets aside the ISA I/O range (0x100 - 0x3FF) during PCI enumeration
/// and the aliases of the VGA I/O ranges. By using this selection, the
/// platform indicates that it will support VGA devices that require VGA
/// ranges, including those that require VGA aliases. The platform further
-/// wants to support non-VGA devices that ask for the ISA range (0x100
+/// wants to support non-VGA devices that ask for the ISA range (0x100 -
/// 3FF), but not if it also asks for the ISA aliases. The PCI bus driver will
-/// not allocate I/O addresses out of the legacy ISA I/O range (0x100
+/// not allocate I/O addresses out of the legacy ISA I/O range (0x100 -
/// 0x3FF) range or the aliases of the VGA I/O range. If a PCI device
/// driver asks for the ISA I/O ranges, including aliases, the request will be
/// turned down. The first device that requests the legacy VGA range will
@@ -95,13 +95,13 @@ typedef struct _EFI_PCI_PLATFORM_PROTOCOL EFI_PCI_PLATFORM_PROTOCOL;
/// and Windows Server 2003. The PCI enumeration process must be
/// cognizant of this restriction.
/// - EFI_RESERVE_ISA_IO_NO_ALIAS | EFI_RESERVE_VGA_IO_NO_ALIAS:
-/// Sets aside the ISA I/O range (0x1000x3FF) during PCI enumeration.
+/// Sets aside the ISA I/O range (0x100 - 0x3FF) during PCI enumeration.
/// VGA I/O ranges are included in the ISA range. By using this selection,
/// the platform indicates that it wants to support PCI devices that require
/// the ISA range and legacy VGA range, but it does not want to support
/// devices that require ISA alias ranges or VGA alias ranges. The PCI
/// bus driver will not allocate I/O addresses out of the legacy ISA I/O
-/// range (0x1000x3FF). If a PCI device driver asks for the ISA I/O
+/// range (0x100-0x3FF). If a PCI device driver asks for the ISA I/O
/// ranges, including aliases, the request will be turned down. By using
/// this selection, the platform indicates that it will support VGA devices
/// that require VGA ranges, but it will not support VGA devices that
@@ -125,26 +125,26 @@ typedef UINT32 EFI_PCI_PLATFORM_POLICY;
#define EFI_RESERVE_NONE_IO_ALIAS 0x0000
///
-/// Sets aside ISA I/O range and all aliases
+/// Sets aside ISA I/O range and all aliases:
/// - n100..n3FF
/// - n500..n7FF
/// - n900..nBFF
-/// - nD00..nFFF
+/// - nD00..nFFF.
///
#define EFI_RESERVE_ISA_IO_ALIAS 0x0001
///
-/// Sets aside ISA I/O range 0x100-0x3FF
+/// Sets aside ISA I/O range 0x100-0x3FF.
///
#define EFI_RESERVE_ISA_IO_NO_ALIAS 0x0002
///
-/// Sets aside VGA I/O ranges and all aliases
+/// Sets aside VGA I/O ranges and all aliases.
///
#define EFI_RESERVE_VGA_IO_ALIAS 0x0004
///
-/// Sets aside VGA I/O rangess
+/// Sets aside VGA I/O ranges
///
#define EFI_RESERVE_VGA_IO_NO_ALIAS 0x0008
@@ -200,10 +200,10 @@ typedef EFI_PCI_EXECUTION_PHASE EFI_PCI_CHIPSET_EXECUTION_PHASE;
it needs to handle those errors on its own because there is no way to surface any
errors to the caller.
- @param[in] This Pointer to the EFI_PCI_PLATFORM_PROTOCOL instance.
+ @param[in] This The pointer to the EFI_PCI_PLATFORM_PROTOCOL instance.
@param[in] HostBridge The handle of the host bridge controller.
@param[in] Phase The phase of the PCI bus enumeration.
- @param[in] ChipsetPhase Defines the execution phase of the PCI chipset driver.
+ @param[in] ExecPhase Defines the execution phase of the PCI chipset driver.
@retval EFI_SUCCESS The function completed successfully.
@@ -214,7 +214,7 @@ EFI_STATUS
IN EFI_PCI_PLATFORM_PROTOCOL *This,
IN EFI_HANDLE HostBridge,
IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE Phase,
- IN EFI_PCI_CHIPSET_EXECUTION_PHASE ChipsetPhase
+ IN EFI_PCI_EXECUTION_PHASE ExecPhase
);
/**
@@ -233,12 +233,12 @@ EFI_STATUS
needs to handle those errors on its own because there is no way to surface any errors to
the caller.
- @param[in] This Pointer to the EFI_PCI_PLATFORM_PROTOCOL instance.
+ @param[in] This The pointer to the EFI_PCI_PLATFORM_PROTOCOL instance.
@param[in] HostBridge The associated PCI host bridge handle.
@param[in] RootBridge The associated PCI root bridge handle.
@param[in] PciAddress The address of the PCI device on the PCI bus.
@param[in] Phase The phase of the PCI controller enumeration.
- @param[in] ChipsetPhase Defines the execution phase of the PCI chipset driver.
+ @param[in] ExecPhase Defines the execution phase of the PCI chipset driver.
@retval EFI_SUCCESS The function completed successfully.
@@ -251,7 +251,7 @@ EFI_STATUS
IN EFI_HANDLE RootBridge,
IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_PCI_ADDRESS PciAddress,
IN EFI_PCI_CONTROLLER_RESOURCE_ALLOCATION_PHASE Phase,
- IN EFI_PCI_CHIPSET_EXECUTION_PHASE ChipsetPhase
+ IN EFI_PCI_EXECUTION_PHASE ExecPhase
);
/**
@@ -261,7 +261,7 @@ EFI_STATUS
enumeration. The PCI bus driver and the PCI Host Bridge Resource Allocation Protocol
driver can call this member function to retrieve the policy.
- @param[in] This Pointer to the EFI_PCI_PLATFORM_PROTOCOL instance.
+ @param[in] This The pointer to the EFI_PCI_PLATFORM_PROTOCOL instance.
@param[out] PciPolicy The platform policy with respect to VGA and ISA aliasing.
@retval EFI_SUCCESS The function completed successfully.
@@ -271,8 +271,8 @@ EFI_STATUS
typedef
EFI_STATUS
(EFIAPI *EFI_PCI_PLATFORM_GET_PLATFORM_POLICY)(
- IN EFI_PCI_PLATFORM_PROTOCOL *This,
- OUT EFI_PCI_PLATFORM_POLICY *PciPolicy
+ IN CONST EFI_PCI_PLATFORM_PROTOCOL *This,
+ OUT EFI_PCI_PLATFORM_POLICY *PciPolicy
);
/**
@@ -288,7 +288,7 @@ EFI_STATUS
scanning the ROM that is attached to any controller, which allows a platform to specify a ROM
image that is different from the ROM image on a PCI card.
- @param[in] This Pointer to the EFI_PCI_PLATFORM_PROTOCOL instance.
+ @param[in] This The pointer to the EFI_PCI_PLATFORM_PROTOCOL instance.
@param[in] PciHandle The handle of the PCI device.
@param[out] RomImage If the call succeeds, the pointer to the pointer to the option ROM image.
Otherwise, this field is undefined. The memory for RomImage is allocated
@@ -301,16 +301,16 @@ EFI_STATUS
@retval EFI_SUCCESS The option ROM was available for this device and loaded into memory.
@retval EFI_NOT_FOUND No option ROM was available for this device.
@retval EFI_OUT_OF_RESOURCES No memory was available to load the option ROM.
- @retval EFI_DEVICE_ERROR An error occurred in getting the option ROM.
+ @retval EFI_DEVICE_ERROR An error occurred in obtaining the option ROM.
**/
typedef
EFI_STATUS
(EFIAPI *EFI_PCI_PLATFORM_GET_PCI_ROM)(
- IN EFI_PCI_PLATFORM_PROTOCOL *This,
- IN EFI_HANDLE PciHandle,
- OUT VOID **RomImage,
- OUT UINTN *RomSize
+ IN CONST EFI_PCI_PLATFORM_PROTOCOL *This,
+ IN EFI_HANDLE PciHandle,
+ OUT VOID **RomImage,
+ OUT UINTN *RomSize
);
///
@@ -334,7 +334,7 @@ struct _EFI_PCI_PLATFORM_PROTOCOL {
///
EFI_PCI_PLATFORM_GET_PLATFORM_POLICY GetPlatformPolicy;
///
- /// Gets the PCI devices option ROM from a platform-specific location.
+ /// Gets the PCI device's option ROM from a platform-specific location.
///
EFI_PCI_PLATFORM_GET_PCI_ROM GetPciRom;
};