mirror of
https://github.com/tianocore/edk2
synced 2026-08-27 00:23:19 -04:00
7a934d0bef
Replace traditional `#ifndef`/`#define`/`#endif` include guards with
`#pragma` once.
`#pragma once` is a widely supported preprocessor directive that
prevents header files from being included multiple times. It is
supported by all toolchains used to build edk2: GCC, Clang/LLVM, and
MSVC.
Compared to macro-based include guards, `#pragma once`:
- Eliminates the risk of macro name collisions or copy/paste errors
where two headers inadvertently use the same guard macro.
- Eliminate inconsistency in the way include guard macros are named
(e.g., some files use `__FILE_H__`, others use `FILE_H_`, etc.).
- Reduces boilerplate (three lines replaced by one).
- Avoids polluting the macro namespace with guard symbols.
- Can improve build times as the preprocessor can skip re-opening the
file entirely, rather than re-reading it to find the matching
`#endif` ("multiple-include optimization").
- Note that some compilers may already optimize traditional include
guards, by recognzining the idiomatic pattern.
This change is made acknowledging that overall portability of the
code will technically be reduced, as `#pragma once` is not part of the
C/C++ standards.
However, this is considered acceptable given:
1. edk2 already defines a subset of supported compilers in
BaseTools/Conf/tools_def.template, all of which have supported
`#pragma once` for over two decades.
2. There have been concerns raised to the project about inconsistent
include guard naming and potential macro collisions.
Approximate compiler support dates:
- MSVC: Supported since Visual C++ 4.2 (1996)
- GCC: Supported since 3.4 (2004)
(http://gnu.ist.utl.pt/software/gcc/gcc-3.4/changes.html)
- Clang (LLVM based): Since initial release in 2007
Signed-off-by: Michael Kubacki <michael.kubacki@microsoft.com>
84 lines
2.7 KiB
C
84 lines
2.7 KiB
C
/** @file
|
|
Define APIs to retrieve USB Host Controller Info such as controller type and
|
|
I/O Port Base Address.
|
|
|
|
Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
|
|
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#pragma once
|
|
|
|
///
|
|
/// Global ID for the PEI_USB_CONTROLLER_PPI.
|
|
///
|
|
#define PEI_USB_CONTROLLER_PPI_GUID \
|
|
{ \
|
|
0x3bc1f6de, 0x693e, 0x4547,{ 0xa3, 0x0, 0x21, 0x82, 0x3c, 0xa4, 0x20, 0xb2} \
|
|
}
|
|
|
|
///
|
|
/// Forward declaration for the PEI_USB_CONTROLLER_PPI.
|
|
///
|
|
typedef struct _PEI_USB_CONTROLLER_PPI PEI_USB_CONTROLLER_PPI;
|
|
|
|
///
|
|
/// This bit is used in the ControllerType return parameter of GetUsbController()
|
|
/// to identify the USB Host Controller type as UHCI
|
|
///
|
|
#define PEI_UHCI_CONTROLLER 0x01
|
|
|
|
///
|
|
/// This bit is used in the ControllerType return parameter of GetUsbController()
|
|
/// to identify the USB Host Controller type as OHCI
|
|
///
|
|
#define PEI_OHCI_CONTROLLER 0x02
|
|
|
|
///
|
|
/// This bit is used in the ControllerType return parameter of GetUsbController()
|
|
/// to identify the USB Host Controller type as EHCI
|
|
///
|
|
#define PEI_EHCI_CONTROLLER 0x03
|
|
|
|
///
|
|
/// This bit is used in the ControllerType return parameter of GetUsbController()
|
|
/// to identify the USB Host Controller type as XHCI
|
|
///
|
|
#define PEI_XHCI_CONTROLLER 0x04
|
|
|
|
/**
|
|
Retrieve USB Host Controller Info such as controller type and I/O Base Address.
|
|
|
|
@param[in] PeiServices The pointer to the PEI Services Table.
|
|
@param[in] This The pointer to this instance of the PEI_USB_CONTROLLER_PPI.
|
|
@param[in] ControllerId The ID of the USB controller.
|
|
@param[out] ControllerType On output, returns the type of the USB controller.
|
|
@param[out] BaseAddress On output, returns the base address of UHCI's I/O ports
|
|
if UHCI is enabled or the base address of EHCI's MMIO
|
|
if EHCI is enabled.
|
|
|
|
@retval EFI_SUCCESS USB controller attributes were returned successfully.
|
|
@retval EFI_INVALID_PARAMETER ControllerId is greater than the maximum number
|
|
of USB controller supported by this platform.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *PEI_GET_USB_CONTROLLER)(
|
|
IN EFI_PEI_SERVICES **PeiServices,
|
|
IN PEI_USB_CONTROLLER_PPI *This,
|
|
IN UINT8 UsbControllerId,
|
|
OUT UINTN *ControllerType,
|
|
OUT UINTN *BaseAddress
|
|
);
|
|
|
|
///
|
|
/// This PPI contains a single service to retrieve the USB Host Controller type
|
|
/// and the base address of the I/O ports used to access the USB Host Controller.
|
|
///
|
|
struct _PEI_USB_CONTROLLER_PPI {
|
|
PEI_GET_USB_CONTROLLER GetUsbController;
|
|
};
|
|
|
|
extern EFI_GUID gPeiUsbControllerPpiGuid;
|