2 Header file of PciHostBridgeLib.
4 Copyright (C) 2016, Red Hat, Inc.
5 Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>
7 SPDX-License-Identifier: BSD-2-Clause-Patent
11 #ifndef _PCI_HOST_BRIDGE_H
12 #define _PCI_HOST_BRIDGE_H
15 ACPI_HID_DEVICE_PATH AcpiDevicePath
;
16 EFI_DEVICE_PATH_PROTOCOL EndDevicePath
;
17 } CB_PCI_ROOT_BRIDGE_DEVICE_PATH
;
21 UINTN
*NumberOfRootBridges
25 Initialize a PCI_ROOT_BRIDGE structure.
27 @param[in] Supports Supported attributes.
29 @param[in] Attributes Initial attributes.
31 @param[in] AllocAttributes Allocation attributes.
33 @param[in] RootBusNumber The bus number to store in RootBus.
35 @param[in] MaxSubBusNumber The inclusive maximum bus number that can be
36 assigned to any subordinate bus found behind any
37 PCI bridge hanging off this root bus.
39 The caller is responsible for ensuring that
40 RootBusNumber <= MaxSubBusNumber. If
41 RootBusNumber equals MaxSubBusNumber, then the
42 root bus has no room for subordinate buses.
44 @param[in] Io IO aperture.
46 @param[in] Mem MMIO aperture.
48 @param[in] MemAbove4G MMIO aperture above 4G.
50 @param[in] PMem Prefetchable MMIO aperture.
52 @param[in] PMemAbove4G Prefetchable MMIO aperture above 4G.
54 @param[out] RootBus The PCI_ROOT_BRIDGE structure (allocated by the
55 caller) that should be filled in by this
58 @retval EFI_SUCCESS Initialization successful. A device path
59 consisting of an ACPI device path node, with
60 UID = RootBusNumber, has been allocated and
63 @retval EFI_OUT_OF_RESOURCES Memory allocation failed.
69 IN UINT64 AllocAttributes
,
70 IN UINT8 RootBusNumber
,
71 IN UINT8 MaxSubBusNumber
,
72 IN PCI_ROOT_BRIDGE_APERTURE
*Io
,
73 IN PCI_ROOT_BRIDGE_APERTURE
*Mem
,
74 IN PCI_ROOT_BRIDGE_APERTURE
*MemAbove4G
,
75 IN PCI_ROOT_BRIDGE_APERTURE
*PMem
,
76 IN PCI_ROOT_BRIDGE_APERTURE
*PMemAbove4G
,
77 OUT PCI_ROOT_BRIDGE
*RootBus