mirror of https://github.com/acidanthera/audk.git
Clean up doxygen comments
Remove *_GRANULARITY #defines that are not defined in the Framework CSM Specification git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@8911 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
parent
82336c28c5
commit
050b79ebb0
|
@ -794,12 +794,10 @@ typedef struct {
|
||||||
#define OEM_OWNER 0x1
|
#define OEM_OWNER 0x1
|
||||||
///@}
|
///@}
|
||||||
|
|
||||||
/**
|
///
|
||||||
* SMM_ENTRY
|
/// This structure assumes both port and data sizes are 1. SmmAttribute must be
|
||||||
*
|
/// properly to reflect that assumption.
|
||||||
* This structure assumes both port and data sizes are 1. SmmAttribute must be
|
///
|
||||||
* properly to reflect that assumption.
|
|
||||||
**/
|
|
||||||
typedef struct {
|
typedef struct {
|
||||||
///
|
///
|
||||||
/// Describes the access mechanism, SmmPort, and SmmData sizes. Type
|
/// Describes the access mechanism, SmmPort, and SmmData sizes. Type
|
||||||
|
@ -976,32 +974,29 @@ typedef struct {
|
||||||
|
|
||||||
typedef struct _EFI_LEGACY_BIOS_PROTOCOL EFI_LEGACY_BIOS_PROTOCOL;
|
typedef struct _EFI_LEGACY_BIOS_PROTOCOL EFI_LEGACY_BIOS_PROTOCOL;
|
||||||
|
|
||||||
//
|
///
|
||||||
// Flags returned by CheckPciRom()
|
/// Flags returned by CheckPciRom()
|
||||||
//
|
///
|
||||||
#define NO_ROM 0x00
|
#define NO_ROM 0x00
|
||||||
#define ROM_FOUND 0x01
|
#define ROM_FOUND 0x01
|
||||||
#define VALID_LEGACY_ROM 0x02
|
#define VALID_LEGACY_ROM 0x02
|
||||||
#define ROM_WITH_CONFIG 0x04 // Not defined in CSM Specification0.96
|
#define ROM_WITH_CONFIG 0x04 ///> Not defined in the Framework CSM Specification
|
||||||
|
|
||||||
//
|
///
|
||||||
/// @bug These macros appear in no specifications and are kept for backward
|
/// The following macros do not appear in the Framework CSM Specification and
|
||||||
// compatibility only.
|
/// are kept for backward compatibility only. They convert 32-bit address (_Adr)
|
||||||
// Convert from 32-bit address (_Adr) to Segment:Offset 16-bit form
|
/// to Segment:Offset 16-bit form.
|
||||||
//
|
///
|
||||||
|
/// @{
|
||||||
#define EFI_SEGMENT(_Adr) (UINT16) ((UINT16) (((UINTN) (_Adr)) >> 4) & 0xf000)
|
#define EFI_SEGMENT(_Adr) (UINT16) ((UINT16) (((UINTN) (_Adr)) >> 4) & 0xf000)
|
||||||
#define EFI_OFFSET(_Adr) (UINT16) (((UINT16) ((UINTN) (_Adr))) & 0xffff)
|
#define EFI_OFFSET(_Adr) (UINT16) (((UINT16) ((UINTN) (_Adr))) & 0xffff)
|
||||||
#define BYTE_GRANULARITY 0x01
|
/// @}
|
||||||
#define WORD_GRANULARITY 0x02
|
|
||||||
#define DWORD_GRANULARITY 0x04
|
|
||||||
#define QWORD_GRANULARITY 0x08
|
|
||||||
#define PARAGRAPH_GRANULARITY 0x10
|
|
||||||
|
|
||||||
#define CARRY_FLAG 0x01
|
#define CARRY_FLAG 0x01
|
||||||
|
|
||||||
//*********************************************************
|
///
|
||||||
// EFI_EFLAGS_REG
|
/// EFI_EFLAGS_REG
|
||||||
//*********************************************************
|
///
|
||||||
typedef struct {
|
typedef struct {
|
||||||
UINT32 CF:1;
|
UINT32 CF:1;
|
||||||
UINT32 Reserved1:1;
|
UINT32 Reserved1:1;
|
||||||
|
@ -1022,10 +1017,9 @@ typedef struct {
|
||||||
UINT32 Reserved5:14;
|
UINT32 Reserved5:14;
|
||||||
} EFI_EFLAGS_REG;
|
} EFI_EFLAGS_REG;
|
||||||
|
|
||||||
//*********************************************************
|
///
|
||||||
// EFI_DWORD_REGS
|
/// EFI_DWORD_REGS
|
||||||
//*********************************************************
|
///
|
||||||
|
|
||||||
typedef struct {
|
typedef struct {
|
||||||
UINT32 EAX;
|
UINT32 EAX;
|
||||||
UINT32 EBX;
|
UINT32 EBX;
|
||||||
|
@ -1044,9 +1038,9 @@ typedef struct {
|
||||||
UINT32 ESP;
|
UINT32 ESP;
|
||||||
} EFI_DWORD_REGS;
|
} EFI_DWORD_REGS;
|
||||||
|
|
||||||
//*******************************************
|
///
|
||||||
// EFI_FLAGS_REG
|
/// EFI_FLAGS_REG
|
||||||
//*******************************************
|
///
|
||||||
typedef struct {
|
typedef struct {
|
||||||
UINT16 CF:1;
|
UINT16 CF:1;
|
||||||
UINT16 Reserved1:1;
|
UINT16 Reserved1:1;
|
||||||
|
@ -1065,11 +1059,9 @@ typedef struct {
|
||||||
UINT16 Reserved4:1;
|
UINT16 Reserved4:1;
|
||||||
} EFI_FLAGS_REG;
|
} EFI_FLAGS_REG;
|
||||||
|
|
||||||
|
///
|
||||||
//*********************************************************
|
/// EFI_WORD_REGS
|
||||||
// EFI_WORD_REGS
|
///
|
||||||
//*********************************************************
|
|
||||||
|
|
||||||
typedef struct {
|
typedef struct {
|
||||||
UINT16 AX;
|
UINT16 AX;
|
||||||
UINT16 ReservedAX;
|
UINT16 ReservedAX;
|
||||||
|
@ -1097,10 +1089,9 @@ typedef struct {
|
||||||
UINT16 ReservedSP;
|
UINT16 ReservedSP;
|
||||||
} EFI_WORD_REGS;
|
} EFI_WORD_REGS;
|
||||||
|
|
||||||
//*********************************************************
|
///
|
||||||
// EFI_BYTE_REGS
|
/// EFI_BYTE_REGS
|
||||||
//*********************************************************
|
///
|
||||||
|
|
||||||
typedef struct {
|
typedef struct {
|
||||||
UINT8 AL, AH;
|
UINT8 AL, AH;
|
||||||
UINT16 ReservedAX;
|
UINT16 ReservedAX;
|
||||||
|
@ -1112,6 +1103,9 @@ typedef struct {
|
||||||
UINT16 ReservedDX;
|
UINT16 ReservedDX;
|
||||||
} EFI_BYTE_REGS;
|
} EFI_BYTE_REGS;
|
||||||
|
|
||||||
|
///
|
||||||
|
/// EFI_IA32_REGISTER_SET
|
||||||
|
///
|
||||||
typedef union {
|
typedef union {
|
||||||
EFI_DWORD_REGS E;
|
EFI_DWORD_REGS E;
|
||||||
EFI_WORD_REGS X;
|
EFI_WORD_REGS X;
|
||||||
|
@ -1123,9 +1117,9 @@ typedef union {
|
||||||
of BiosInt. Regs will contain the 16-bit register context on entry and
|
of BiosInt. Regs will contain the 16-bit register context on entry and
|
||||||
exit.
|
exit.
|
||||||
|
|
||||||
@param This Protocol instance pointer.
|
@param[in] This Protocol instance pointer.
|
||||||
@param BiosInt Processor interrupt vector to invoke
|
@param[in] BiosInt Processor interrupt vector to invoke
|
||||||
@param Reg Register contexted passed into (and returned) from thunk to
|
@param[in,out] Reg Register contexted passed into (and returned) from thunk to
|
||||||
16-bit mode
|
16-bit mode
|
||||||
|
|
||||||
@retval FALSE Thunk completed, and there were no BIOS errors in the target code.
|
@retval FALSE Thunk completed, and there were no BIOS errors in the target code.
|
||||||
|
@ -1146,13 +1140,13 @@ BOOLEAN
|
||||||
16-bit register context on entry and exit. Arguments can be passed on
|
16-bit register context on entry and exit. Arguments can be passed on
|
||||||
the Stack argument
|
the Stack argument
|
||||||
|
|
||||||
@param This Protocol instance pointer.
|
@param[in] This Protocol instance pointer.
|
||||||
@param Segment Segemnt of 16-bit mode call
|
@param[in] Segment Segemnt of 16-bit mode call
|
||||||
@param Offset Offset of 16-bit mdoe call
|
@param[in] Offset Offset of 16-bit mdoe call
|
||||||
@param Reg Register contexted passed into (and returned) from thunk to
|
@param[in] Reg Register contexted passed into (and returned) from thunk to
|
||||||
16-bit mode
|
16-bit mode
|
||||||
@param Stack Caller allocated stack used to pass arguments
|
@param[in] Stack Caller allocated stack used to pass arguments
|
||||||
@param StackSize Size of Stack in bytes
|
@param[in] StackSize Size of Stack in bytes
|
||||||
|
|
||||||
@retval FALSE Thunk completed, and there were no BIOS errors in the target code.
|
@retval FALSE Thunk completed, and there were no BIOS errors in the target code.
|
||||||
See Regs for status.
|
See Regs for status.
|
||||||
|
@ -1174,14 +1168,14 @@ BOOLEAN
|
||||||
Test to see if a legacy PCI ROM exists for this device. Optionally return
|
Test to see if a legacy PCI ROM exists for this device. Optionally return
|
||||||
the Legacy ROM instance for this PCI device.
|
the Legacy ROM instance for this PCI device.
|
||||||
|
|
||||||
@param This Protocol instance pointer.
|
@param[in] This Protocol instance pointer.
|
||||||
@param PciHandle The PCI PC-AT OPROM from this devices ROM BAR will be loaded
|
@param[in] PciHandle The PCI PC-AT OPROM from this devices ROM BAR will be loaded
|
||||||
@param RomImage Return the legacy PCI ROM for this device
|
@param[out] RomImage Return the legacy PCI ROM for this device
|
||||||
@param RomSize Size of ROM Image
|
@param[out] RomSize Size of ROM Image
|
||||||
@param Flags Indicates if ROM found and if PC-AT. Multiple bits can be set as follows:
|
@param[out] Flags Indicates if ROM found and if PC-AT. Multiple bits can be set as follows:
|
||||||
00 = No ROM
|
- 00 = No ROM
|
||||||
01 = ROM Found
|
- 01 = ROM Found
|
||||||
02 = ROM is a valid legacy ROM
|
- 02 = ROM is a valid legacy ROM
|
||||||
|
|
||||||
@retval EFI_SUCCESS Legacy Option ROM availible for this device
|
@retval EFI_SUCCESS Legacy Option ROM availible for this device
|
||||||
@retval EFI_UNSUPPORTED Legacy Option ROM not supported.
|
@retval EFI_UNSUPPORTED Legacy Option ROM not supported.
|
||||||
|
@ -1202,23 +1196,23 @@ EFI_STATUS
|
||||||
about how many disks were added by the OPROM and the shadow address and
|
about how many disks were added by the OPROM and the shadow address and
|
||||||
size. DiskStart & DiskEnd are INT 13h drive letters. Thus 0x80 is C:
|
size. DiskStart & DiskEnd are INT 13h drive letters. Thus 0x80 is C:
|
||||||
|
|
||||||
@param This Protocol instance pointer.
|
@param[in] This Protocol instance pointer.
|
||||||
@param PciHandle The PCI PC-AT OPROM from this devices ROM BAR will be loaded.
|
@param[in] PciHandle The PCI PC-AT OPROM from this devices ROM BAR will be loaded.
|
||||||
This value is NULL if RomImage is non-NULL. This is the normal
|
This value is NULL if RomImage is non-NULL. This is the normal
|
||||||
case.
|
case.
|
||||||
@param RomImage A PCI PC-AT ROM image. This argument is non-NULL if there is
|
@param[in] RomImage A PCI PC-AT ROM image. This argument is non-NULL if there is
|
||||||
no hardware associated with the ROM and thus no PciHandle,
|
no hardware associated with the ROM and thus no PciHandle,
|
||||||
otherwise is must be NULL.
|
otherwise is must be NULL.
|
||||||
Example is PXE base code.
|
Example is PXE base code.
|
||||||
@param Flags The type of ROM discovered. Multiple bits can be set, as follows:
|
@param[out] Flags The type of ROM discovered. Multiple bits can be set, as follows:
|
||||||
00 = No ROM.
|
- 00 = No ROM.
|
||||||
01 = ROM found.
|
- 01 = ROM found.
|
||||||
02 = ROM is a valid legacy ROM.
|
- 02 = ROM is a valid legacy ROM.
|
||||||
@param DiskStart Disk number of first device hooked by the ROM. If DiskStart
|
@param[out] DiskStart Disk number of first device hooked by the ROM. If DiskStart
|
||||||
is the same as DiskEnd no disked were hooked.
|
is the same as DiskEnd no disked were hooked.
|
||||||
@param DiskEnd Disk number of the last device hooked by the ROM.
|
@param[out] DiskEnd disk number of the last device hooked by the ROM.
|
||||||
@param RomShadowAddress Shadow address of PC-AT ROM
|
@param[out] RomShadowAddress Shadow address of PC-AT ROM
|
||||||
@param RomShadowSize Size of RomShadowAddress in bytes
|
@param[out] RomShadowSize Size of RomShadowAddress in bytes
|
||||||
|
|
||||||
@retval EFI_SUCCESS Thunk completed, see Regs for status.
|
@retval EFI_SUCCESS Thunk completed, see Regs for status.
|
||||||
@retval EFI_INVALID_PARAMETER PciHandle not found
|
@retval EFI_INVALID_PARAMETER PciHandle not found
|
||||||
|
@ -1261,10 +1255,10 @@ EFI_STATUS
|
||||||
manner—i.e., EFI code is still valid. An ungraceful boot failure causes a reset because the state
|
manner—i.e., EFI code is still valid. An ungraceful boot failure causes a reset because the state
|
||||||
of EFI code is unknown.
|
of EFI code is unknown.
|
||||||
|
|
||||||
@param This Protocol instance pointer.
|
@param[in] This Protocol instance pointer.
|
||||||
@param BootOption EFI Device Path from BootXXXX variable.
|
@param[in] BootOption EFI Device Path from BootXXXX variable.
|
||||||
@param LoadOptionSize Size of LoadOption in size.
|
@param[in] LoadOptionSize Size of LoadOption in size.
|
||||||
@param LoadOption LoadOption from BootXXXX variable
|
@param[in] LoadOption LoadOption from BootXXXX variable
|
||||||
|
|
||||||
@retval EFI_DEVICE_ERROR Failed to boot from any boot device and memory is uncorrupted.
|
@retval EFI_DEVICE_ERROR Failed to boot from any boot device and memory is uncorrupted.
|
||||||
Note: This function normally never returns. It will either boot the
|
Note: This function normally never returns. It will either boot the
|
||||||
|
@ -1288,11 +1282,11 @@ EFI_STATUS
|
||||||
keyboard options such as boot with NUM LOCK on/off. This function does not
|
keyboard options such as boot with NUM LOCK on/off. This function does not
|
||||||
touch the keyboard or keyboard LEDs but only the BDA.
|
touch the keyboard or keyboard LEDs but only the BDA.
|
||||||
|
|
||||||
@param This Protocol instance pointer.
|
@param[in] This Protocol instance pointer.
|
||||||
@param Leds Status of current Scroll, Num & Cap lock LEDS
|
@param[in] Leds Status of current Scroll, Num & Cap lock LEDS
|
||||||
Bit 0 is Scroll Lock 0 = Not locked
|
- Bit 0 is Scroll Lock 0 = Not locked
|
||||||
Bit 1 is Num Lock
|
- Bit 1 is Num Lock
|
||||||
Bit 2 is Caps Lock
|
- Bit 2 is Caps Lock
|
||||||
|
|
||||||
@retval EFI_SUCCESS The BDA was updated successfully.
|
@retval EFI_SUCCESS The BDA was updated successfully.
|
||||||
|
|
||||||
|
@ -1307,11 +1301,11 @@ EFI_STATUS
|
||||||
/**
|
/**
|
||||||
Retrieve legacy BBS info and assign boot priority.
|
Retrieve legacy BBS info and assign boot priority.
|
||||||
|
|
||||||
@param This Protocol instance pointer.
|
@param[in] This Protocol instance pointer.
|
||||||
@param HddCount Number of HDD_INFO structures
|
@param[out] HddCount Number of HDD_INFO structures
|
||||||
@param HddInfo Onboard IDE controller information
|
@param[out] HddInfo Onboard IDE controller information
|
||||||
@param BbsCount Number of BBS_TABLE structures
|
@param[out] BbsCount Number of BBS_TABLE structures
|
||||||
@param BbsTable Point to List of BBS_TABLE
|
@param[in,out] BbsTable Point to List of BBS_TABLE
|
||||||
|
|
||||||
@retval EFI_SUCCESS Tables returned
|
@retval EFI_SUCCESS Tables returned
|
||||||
|
|
||||||
|
@ -1330,9 +1324,9 @@ EFI_STATUS
|
||||||
Assign drive number to legacy HDD drives prior to booting an EFI
|
Assign drive number to legacy HDD drives prior to booting an EFI
|
||||||
aware OS so the OS can access drives without an EFI driver.
|
aware OS so the OS can access drives without an EFI driver.
|
||||||
|
|
||||||
@param This Protocol instance pointer.
|
@param[in] This Protocol instance pointer.
|
||||||
@param BbsCount Number of BBS_TABLE structures
|
@param[out] BbsCount Number of BBS_TABLE structures
|
||||||
@param BbsTable List BBS entries
|
@param[out] BbsTable List BBS entries
|
||||||
|
|
||||||
@retval EFI_SUCCESS Drive numbers assigned
|
@retval EFI_SUCCESS Drive numbers assigned
|
||||||
|
|
||||||
|
@ -1349,16 +1343,16 @@ EFI_STATUS
|
||||||
To boot from an unconventional device like parties and/or execute
|
To boot from an unconventional device like parties and/or execute
|
||||||
HDD diagnostics.
|
HDD diagnostics.
|
||||||
|
|
||||||
@param This Protocol instance pointer.
|
@param[in] This Protocol instance pointer.
|
||||||
@param Attributes How to interpret the other input parameters
|
@param[in] Attributes How to interpret the other input parameters
|
||||||
@param BbsEntry The 0-based index into the BbsTable for the parent
|
@param[in] BbsEntry The 0-based index into the BbsTable for the parent
|
||||||
device.
|
device.
|
||||||
@param BeerData Pointer to the 128 bytes of ram BEER data.
|
@param[in] BeerData Pointer to the 128 bytes of ram BEER data.
|
||||||
@param ServiceAreaData Pointer to the 64 bytes of raw Service Area data. The
|
@param[in] ServiceAreaData Pointer to the 64 bytes of raw Service Area data. The
|
||||||
caller must provide a pointer to the specific Service
|
caller must provide a pointer to the specific Service
|
||||||
Area and not the start all Service Areas.
|
Area and not the start all Service Areas.
|
||||||
|
|
||||||
@retval EFI_INVALID_PARAMETER if error. Does NOT return if no error.
|
@retval EFI_INVALID_PARAMETER If error. Does NOT return if no error.
|
||||||
|
|
||||||
**/
|
**/
|
||||||
typedef
|
typedef
|
||||||
|
@ -1377,6 +1371,8 @@ EFI_STATUS
|
||||||
drivers. If used externally then caller must re-connect EFI
|
drivers. If used externally then caller must re-connect EFI
|
||||||
drivers.
|
drivers.
|
||||||
|
|
||||||
|
@param[in] This Protocol instance pointer.
|
||||||
|
|
||||||
@retval EFI_SUCCESS OPROMs shadowed
|
@retval EFI_SUCCESS OPROMs shadowed
|
||||||
|
|
||||||
**/
|
**/
|
||||||
|
@ -1389,15 +1385,15 @@ EFI_STATUS
|
||||||
/**
|
/**
|
||||||
Get a region from the LegacyBios for S3 usage.
|
Get a region from the LegacyBios for S3 usage.
|
||||||
|
|
||||||
@param This Protocol instance pointer.
|
@param[in] This Protocol instance pointer.
|
||||||
@param LegacyMemorySize Size of required region
|
@param[in] LegacyMemorySize Size of required region
|
||||||
@param Region Region to use.
|
@param[in] Region Region to use.
|
||||||
00 = Either 0xE0000 or 0xF0000 block
|
00 = Either 0xE0000 or 0xF0000 block
|
||||||
Bit0 = 1 0xF0000 block
|
- Bit0 = 1 0xF0000 block
|
||||||
Bit1 = 1 0xE0000 block
|
- Bit1 = 1 0xE0000 block
|
||||||
@param Alignment Address alignment. Bit mapped. First non-zero
|
@param[in] Alignment Address alignment. Bit mapped. First non-zero
|
||||||
bit from right is alignment.
|
bit from right is alignment.
|
||||||
@param LegacyMemoryAddress Region Assigned
|
@param[out] LegacyMemoryAddress Region Assigned
|
||||||
|
|
||||||
@retval EFI_SUCCESS Region assigned
|
@retval EFI_SUCCESS Region assigned
|
||||||
@retval EFI_ACCESS_DENIED The function was previously invoked.
|
@retval EFI_ACCESS_DENIED The function was previously invoked.
|
||||||
|
@ -1417,13 +1413,12 @@ EFI_STATUS
|
||||||
/**
|
/**
|
||||||
Get a region from the LegacyBios for Tiano usage. Can only be invoked once.
|
Get a region from the LegacyBios for Tiano usage. Can only be invoked once.
|
||||||
|
|
||||||
@param This Protocol instance pointer.
|
@param[in] This Protocol instance pointer.
|
||||||
@param LegacyMemorySize Size of data to copy
|
@param[in] LegacyMemorySize Size of data to copy
|
||||||
@param LegacyMemoryAddress Legacy Region destination address
|
@param[in] LegacyMemoryAddress Legacy Region destination address
|
||||||
Note: must be in region assigned by
|
Note: must be in region assigned by
|
||||||
LegacyBiosGetLegacyRegion
|
LegacyBiosGetLegacyRegion
|
||||||
@param LegacyMemorySourceAddress
|
@param[in] LegacyMemorySourceAddress Source of the data to copy.
|
||||||
Source of the data to copy.
|
|
||||||
|
|
||||||
@retval EFI_SUCCESS Region assigned
|
@retval EFI_SUCCESS Region assigned
|
||||||
@retval EFI_ACCESS_DENIED Destination outside assigned region
|
@retval EFI_ACCESS_DENIED Destination outside assigned region
|
||||||
|
@ -1438,12 +1433,12 @@ EFI_STATUS
|
||||||
IN VOID *LegacyMemorySourceAddress
|
IN VOID *LegacyMemorySourceAddress
|
||||||
);
|
);
|
||||||
|
|
||||||
/**
|
///
|
||||||
Abstracts the traditional BIOS from the rest of EFI. The LegacyBoot()
|
/// Abstracts the traditional BIOS from the rest of EFI. The LegacyBoot()
|
||||||
member function allows the BDS to support booting a traditional OS.
|
/// member function allows the BDS to support booting a traditional OS.
|
||||||
EFI thunks drivers that make EFI bindings for BIOS INT services use
|
/// EFI thunks drivers that make EFI bindings for BIOS INT services use
|
||||||
all the other member functions.
|
/// all the other member functions.
|
||||||
**/
|
///
|
||||||
struct _EFI_LEGACY_BIOS_PROTOCOL {
|
struct _EFI_LEGACY_BIOS_PROTOCOL {
|
||||||
///
|
///
|
||||||
/// Performs traditional software INT. See the Int86() function description.
|
/// Performs traditional software INT. See the Int86() function description.
|
||||||
|
|
Loading…
Reference in New Issue