UefiCpuPkg: Move AsmRelocateApLoopStart from Mpfuncs.nasm to AmdSev.nasm

[mirror_edk2.git] / MdeModulePkg / Bus / Pci / PciBusDxe / PciLib.h

/** @file\r
  Internal library declaration for PCI Bus module.\r
\r
Copyright (c) 2006 - 2021, Intel Corporation. All rights reserved.<BR>\r
SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
#ifndef _EFI_PCI_LIB_H_\r
#define _EFI_PCI_LIB_H_\r
\r
typedef struct {\r
  EFI_HANDLE    Handle;\r
} EFI_DEVICE_HANDLE_EXTENDED_DATA_PAYLOAD;\r
\r
typedef struct {\r
  UINT32    Bar;\r
  UINT16    DevicePathSize;\r
  UINT16    ReqResSize;\r
  UINT16    AllocResSize;\r
  UINT8     *DevicePath;\r
  UINT8     *ReqRes;\r
  UINT8     *AllocRes;\r
} EFI_RESOURCE_ALLOC_FAILURE_ERROR_DATA_PAYLOAD;\r
\r
typedef enum {\r
  PciResizableBarMin = 0x00,\r
  PciResizableBarMax = 0xFF\r
} PCI_RESIZABLE_BAR_OPERATION;\r
\r
/**\r
  Retrieve the PCI Card device BAR information via PciIo interface.\r
\r
  @param PciIoDevice        PCI Card device instance.\r
\r
**/\r
VOID\r
GetBackPcCardBar (\r
  IN  PCI_IO_DEVICE  *PciIoDevice\r
  );\r
\r
/**\r
  Remove rejected pci device from specific root bridge\r
  handle.\r
\r
  @param RootBridgeHandle  Specific parent root bridge handle.\r
  @param Bridge            Bridge device instance.\r
\r
**/\r
VOID\r
RemoveRejectedPciDevices (\r
  IN EFI_HANDLE     RootBridgeHandle,\r
  IN PCI_IO_DEVICE  *Bridge\r
  );\r
\r
/**\r
  Submits the I/O and memory resource requirements for the specified PCI Host Bridge.\r
\r
  @param PciResAlloc  Point to protocol instance of EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL.\r
\r
  @retval EFI_SUCCESS           Successfully finished resource allocation.\r
  @retval EFI_NOT_FOUND         Cannot get root bridge instance.\r
  @retval EFI_OUT_OF_RESOURCES  Platform failed to program the resources if no hot plug supported.\r
  @retval other                 Some error occurred when allocating resources for the PCI Host Bridge.\r
\r
  @note   Feature flag PcdPciBusHotplugDeviceSupport determine whether need support hotplug.\r
\r
**/\r
EFI_STATUS\r
PciHostBridgeResourceAllocator (\r
  IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL  *PciResAlloc\r
  );\r
\r
/**\r
  Allocate NumberOfBuses buses and return the next available PCI bus number.\r
\r
  @param  Bridge           Bridge device instance.\r
  @param  StartBusNumber   Current available PCI bus number.\r
  @param  NumberOfBuses    Number of buses enumerated below the StartBusNumber.\r
  @param  NextBusNumber    Next available PCI bus number.\r
\r
  @retval EFI_SUCCESS           Available bus number resource is enough. Next available PCI bus number\r
                                is returned in NextBusNumber.\r
  @retval EFI_OUT_OF_RESOURCES  Available bus number resource is not enough for allocation.\r
\r
**/\r
EFI_STATUS\r
PciAllocateBusNumber (\r
  IN PCI_IO_DEVICE  *Bridge,\r
  IN UINT8          StartBusNumber,\r
  IN UINT8          NumberOfBuses,\r
  OUT UINT8         *NextBusNumber\r
  );\r
\r
/**\r
  Scan pci bus and assign bus number to the given PCI bus system.\r
\r
  @param  Bridge           Bridge device instance.\r
  @param  StartBusNumber   start point.\r
  @param  SubBusNumber     Point to sub bus number.\r
  @param  PaddedBusRange   Customized bus number.\r
\r
  @retval EFI_SUCCESS      Successfully scanned and assigned bus number.\r
  @retval other            Some error occurred when scanning pci bus.\r
\r
  @note   Feature flag PcdPciBusHotplugDeviceSupport determine whether need support hotplug.\r
\r
**/\r
EFI_STATUS\r
PciScanBus (\r
  IN PCI_IO_DEVICE  *Bridge,\r
  IN UINT8          StartBusNumber,\r
  OUT UINT8         *SubBusNumber,\r
  OUT UINT8         *PaddedBusRange\r
  );\r
\r
/**\r
  Process Option Rom on the specified root bridge.\r
\r
  @param Bridge  Pci root bridge device instance.\r
\r
  @retval EFI_SUCCESS   Success process.\r
  @retval other         Some error occurred when processing Option Rom on the root bridge.\r
\r
**/\r
EFI_STATUS\r
PciRootBridgeP2CProcess (\r
  IN PCI_IO_DEVICE  *Bridge\r
  );\r
\r
/**\r
  Process Option Rom on the specified host bridge.\r
\r
  @param PciResAlloc    Pointer to instance of EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL.\r
\r
  @retval EFI_SUCCESS   Success process.\r
  @retval EFI_NOT_FOUND Can not find the root bridge instance.\r
  @retval other         Some error occurred when processing Option Rom on the host bridge.\r
\r
**/\r
EFI_STATUS\r
PciHostBridgeP2CProcess (\r
  IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL  *PciResAlloc\r
  );\r
\r
/**\r
  This function is used to enumerate the entire host bridge\r
  in a given platform.\r
\r
  @param PciResAlloc   A pointer to the PCI Host Resource Allocation protocol.\r
\r
  @retval EFI_SUCCESS            Successfully enumerated the host bridge.\r
  @retval EFI_OUT_OF_RESOURCES   No enough memory available.\r
  @retval other                  Some error occurred when enumerating the host bridge.\r
\r
**/\r
EFI_STATUS\r
PciHostBridgeEnumerator (\r
  IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL  *PciResAlloc\r
  );\r
\r
/**\r
  This function is used to program the Resizable BAR Register.\r
\r
  @param PciIoDevice            A pointer to the PCI_IO_DEVICE.\r
  @param ResizableBarOp         PciResizableBarMax: Set BAR to max size\r
                                PciResizableBarMin: set BAR to min size.\r
\r
  @retval EFI_SUCCESS           Successfully enumerated the host bridge.\r
  @retval other                 Some error occurred when enumerating the host bridge.\r
\r
**/\r
EFI_STATUS\r
PciProgramResizableBar (\r
  IN PCI_IO_DEVICE                *PciIoDevice,\r
  IN PCI_RESIZABLE_BAR_OPERATION  ResizableBarOp\r
  );\r
\r
#endif\r