Fix doxygen issue:
1) comment for structure should be in doxygen format, such as /// , /**, /*! 2) comment for data field of structure should in doxygen format. 3) should not exist blank between ") (" when declaring a type of function point. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@5363 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
@@ -38,10 +38,10 @@
|
||||
#define EFI_HOB_TYPE_UNUSED 0xFFFE
|
||||
#define EFI_HOB_TYPE_END_OF_HOB_LIST 0xFFFF
|
||||
|
||||
//
|
||||
// Describes the format and size of the data inside the HOB.
|
||||
// All HOBs must contain this generic HOB header.
|
||||
//
|
||||
///
|
||||
/// Describes the format and size of the data inside the HOB.
|
||||
/// All HOBs must contain this generic HOB header.
|
||||
///
|
||||
typedef struct {
|
||||
UINT16 HobType;
|
||||
UINT16 HobLength;
|
||||
@@ -49,14 +49,15 @@ typedef struct {
|
||||
} EFI_HOB_GENERIC_HEADER;
|
||||
|
||||
|
||||
//
|
||||
// Value of version ofinEFI_HOB_HANDOFF_INFO_TABLE.
|
||||
//
|
||||
///
|
||||
/// Value of version ofinEFI_HOB_HANDOFF_INFO_TABLE.
|
||||
///
|
||||
#define EFI_HOB_HANDOFF_TABLE_VERSION 0x0009
|
||||
//
|
||||
// Contains general state information used by the HOB producer phase.
|
||||
// This HOB must be the first one in the HOB list.
|
||||
//
|
||||
|
||||
///
|
||||
/// Contains general state information used by the HOB producer phase.
|
||||
/// This HOB must be the first one in the HOB list.
|
||||
///
|
||||
typedef struct {
|
||||
EFI_HOB_GENERIC_HEADER Header;
|
||||
UINT32 Version;
|
||||
@@ -68,25 +69,46 @@ typedef struct {
|
||||
EFI_PHYSICAL_ADDRESS EfiEndOfHobList;
|
||||
} EFI_HOB_HANDOFF_INFO_TABLE;
|
||||
|
||||
|
||||
/// EFI_HOB_MEMORY_ALLOCATION_HEADER describes the
|
||||
/// various attributes of the logical memory allocation. The type field will be used for
|
||||
/// subsequent inclusion in the UEFI memory map.
|
||||
typedef struct {
|
||||
///
|
||||
/// A GUID that defines the memory allocation region<6F><6E>s type and purpose, as well as
|
||||
/// other fields within the memory allocation HOB. This GUID is used to define the
|
||||
/// additional data within the HOB that may be present for the memory allocation HOB.
|
||||
/// Type EFI_GUID is defined in InstallProtocolInterface() in the UEFI 2.0
|
||||
/// specification.
|
||||
///
|
||||
EFI_GUID Name;
|
||||
|
||||
/// The base address of memory allocated by this HOB. Type
|
||||
/// EFI_PHYSICAL_ADDRESS is defined in AllocatePages() in the UEFI 2.0
|
||||
/// specification.
|
||||
EFI_PHYSICAL_ADDRESS MemoryBaseAddress;
|
||||
|
||||
/// The length in bytes of memory allocated by this HOB.
|
||||
UINT64 MemoryLength;
|
||||
|
||||
///
|
||||
/// Defines the type of memory allocated by this HOB. The memory type definition
|
||||
/// follows the EFI_MEMORY_TYPE definition. Type EFI_MEMORY_TYPE is defined
|
||||
/// in AllocatePages() in the UEFI 2.0 specification.
|
||||
///
|
||||
EFI_MEMORY_TYPE MemoryType;
|
||||
|
||||
//
|
||||
// Padding for Itanium processor family
|
||||
//
|
||||
///
|
||||
/// Padding for Itanium processor family
|
||||
///
|
||||
UINT8 Reserved[4];
|
||||
} EFI_HOB_MEMORY_ALLOCATION_HEADER;
|
||||
|
||||
//
|
||||
// Describes all memory ranges used during the HOB producer
|
||||
// phase that exist outside the HOB list. This HOB type
|
||||
// describes how memory is used,
|
||||
// not the physical attributes of memory.
|
||||
//
|
||||
///
|
||||
/// Describes all memory ranges used during the HOB producer
|
||||
/// phase that exist outside the HOB list. This HOB type
|
||||
/// describes how memory is used,
|
||||
/// not the physical attributes of memory.
|
||||
///
|
||||
typedef struct {
|
||||
EFI_HOB_GENERIC_HEADER Header;
|
||||
EFI_HOB_MEMORY_ALLOCATION_HEADER AllocDescriptor;
|
||||
@@ -97,30 +119,30 @@ typedef struct {
|
||||
} EFI_HOB_MEMORY_ALLOCATION;
|
||||
|
||||
|
||||
//
|
||||
// Describes the memory stack that is produced by the HOB producer
|
||||
// phase and upon which all postmemory-installed executable
|
||||
// content in the HOB producer phase is executing.
|
||||
//
|
||||
///
|
||||
/// Describes the memory stack that is produced by the HOB producer
|
||||
/// phase and upon which all postmemory-installed executable
|
||||
/// content in the HOB producer phase is executing.
|
||||
///
|
||||
typedef struct {
|
||||
EFI_HOB_GENERIC_HEADER Header;
|
||||
EFI_HOB_MEMORY_ALLOCATION_HEADER AllocDescriptor;
|
||||
} EFI_HOB_MEMORY_ALLOCATION_STACK;
|
||||
|
||||
//
|
||||
// Defines the location of the boot-strap
|
||||
// processor (BSP) BSPStore ("Backing Store Pointer Store").
|
||||
// This HOB is valid for the Itanium processor family only
|
||||
// register overflow store.
|
||||
//
|
||||
///
|
||||
/// Defines the location of the boot-strap
|
||||
/// processor (BSP) BSPStore ("Backing Store Pointer Store").
|
||||
/// This HOB is valid for the Itanium processor family only
|
||||
/// register overflow store.
|
||||
///
|
||||
typedef struct {
|
||||
EFI_HOB_GENERIC_HEADER Header;
|
||||
EFI_HOB_MEMORY_ALLOCATION_HEADER AllocDescriptor;
|
||||
} EFI_HOB_MEMORY_ALLOCATION_BSP_STORE;
|
||||
|
||||
//
|
||||
// Defines the location and entry point of the HOB consumer phase.
|
||||
//
|
||||
///
|
||||
/// Defines the location and entry point of the HOB consumer phase.
|
||||
///
|
||||
typedef struct {
|
||||
EFI_HOB_GENERIC_HEADER Header;
|
||||
EFI_HOB_MEMORY_ALLOCATION_HEADER MemoryAllocationHeader;
|
||||
@@ -128,6 +150,9 @@ typedef struct {
|
||||
EFI_PHYSICAL_ADDRESS EntryPoint;
|
||||
} EFI_HOB_MEMORY_ALLOCATION_MODULE;
|
||||
|
||||
///
|
||||
/// type of Recount type
|
||||
///
|
||||
typedef UINT32 EFI_RESOURCE_TYPE;
|
||||
|
||||
//
|
||||
@@ -142,7 +167,9 @@ typedef UINT32 EFI_RESOURCE_TYPE;
|
||||
#define EFI_RESOURCE_IO_RESERVED 0x00000006
|
||||
#define EFI_RESOURCE_MAX_MEMORY_TYPE 0x00000007
|
||||
|
||||
|
||||
///
|
||||
/// type of recount attribute type
|
||||
///
|
||||
typedef UINT32 EFI_RESOURCE_ATTRIBUTE_TYPE;
|
||||
|
||||
//
|
||||
@@ -172,11 +199,11 @@ typedef UINT32 EFI_RESOURCE_ATTRIBUTE_TYPE;
|
||||
#define EFI_RESOURCE_ATTRIBUTE_64_BIT_IO 0x00010000
|
||||
#define EFI_RESOURCE_ATTRIBUTE_UNCACHED_EXPORTED 0x00020000
|
||||
|
||||
//
|
||||
// Describes the resource properties of all fixed,
|
||||
// nonrelocatable resource ranges found on the processor
|
||||
// host bus during the HOB producer phase.
|
||||
//
|
||||
///
|
||||
/// Describes the resource properties of all fixed,
|
||||
/// nonrelocatable resource ranges found on the processor
|
||||
/// host bus during the HOB producer phase.
|
||||
///
|
||||
typedef struct {
|
||||
EFI_HOB_GENERIC_HEADER Header;
|
||||
EFI_GUID Owner;
|
||||
@@ -186,32 +213,32 @@ typedef struct {
|
||||
UINT64 ResourceLength;
|
||||
} EFI_HOB_RESOURCE_DESCRIPTOR;
|
||||
|
||||
//
|
||||
// Allows writers of executable content in the HOB producer phase to
|
||||
// maintain and manage HOBs with specific GUID.
|
||||
//
|
||||
///
|
||||
/// Allows writers of executable content in the HOB producer phase to
|
||||
/// maintain and manage HOBs with specific GUID.
|
||||
///
|
||||
typedef struct {
|
||||
EFI_HOB_GENERIC_HEADER Header;
|
||||
EFI_GUID Name;
|
||||
|
||||
//
|
||||
// Guid specific data goes here
|
||||
//
|
||||
///
|
||||
/// Guid specific data goes here
|
||||
///
|
||||
} EFI_HOB_GUID_TYPE;
|
||||
|
||||
//
|
||||
// Details the location of firmware volumes that contain firmware files.
|
||||
//
|
||||
///
|
||||
/// Details the location of firmware volumes that contain firmware files.
|
||||
///
|
||||
typedef struct {
|
||||
EFI_HOB_GENERIC_HEADER Header;
|
||||
EFI_PHYSICAL_ADDRESS BaseAddress;
|
||||
UINT64 Length;
|
||||
} EFI_HOB_FIRMWARE_VOLUME;
|
||||
|
||||
//
|
||||
// Details the location of a firmware volume which was extracted
|
||||
// from a file within another firmware volume.
|
||||
//
|
||||
///
|
||||
/// Details the location of a firmware volume which was extracted
|
||||
/// from a file within another firmware volume.
|
||||
///
|
||||
typedef struct {
|
||||
EFI_HOB_GENERIC_HEADER Header;
|
||||
EFI_PHYSICAL_ADDRESS BaseAddress;
|
||||
@@ -221,9 +248,9 @@ typedef struct {
|
||||
} EFI_HOB_FIRMWARE_VOLUME2;
|
||||
|
||||
|
||||
//
|
||||
// Describes processor information, such as address space and I/O space capabilities.
|
||||
//
|
||||
///
|
||||
/// Describes processor information, such as address space and I/O space capabilities.
|
||||
///
|
||||
typedef struct {
|
||||
EFI_HOB_GENERIC_HEADER Header;
|
||||
UINT8 SizeOfMemorySpace;
|
||||
@@ -232,16 +259,16 @@ typedef struct {
|
||||
} EFI_HOB_CPU;
|
||||
|
||||
|
||||
//
|
||||
// Describes pool memory allocations.
|
||||
//
|
||||
///
|
||||
/// Describes pool memory allocations.
|
||||
///
|
||||
typedef struct {
|
||||
EFI_HOB_GENERIC_HEADER Header;
|
||||
} EFI_HOB_MEMORY_POOL;
|
||||
|
||||
//
|
||||
// Union of all the possible HOB Types
|
||||
//
|
||||
///
|
||||
/// Union of all the possible HOB Types
|
||||
///
|
||||
typedef union {
|
||||
EFI_HOB_GENERIC_HEADER *Header;
|
||||
EFI_HOB_HANDOFF_INFO_TABLE *HandoffInformationTable;
|
||||
|
Reference in New Issue
Block a user