tyler.durden
/
audk
mirror of https://github.com/acidanthera/audk.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Synchronize function comments from library class to library instance. 

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@6938 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
klu2 2008-12-10 01:39:34 +00:00
parent 27a57d4735
commit 80f0c0c44f
5 changed files with 97 additions and 47 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
View File

@ -124,7 +124,6 @@ PeiGetExtractGuidedSectionHandlerInfo (
Sets ExtractHandlerGuidTable so it points at a callee allocated array of registered GUIDs. Sets ExtractHandlerGuidTable so it points at a callee allocated array of registered GUIDs.
The total number of GUIDs in the array are returned. Since the array of GUIDs is callee allocated The total number of GUIDs in the array are returned. Since the array of GUIDs is callee allocated
and caller must treat this array of GUIDs as read-only data. and caller must treat this array of GUIDs as read-only data.
If ExtractHandlerGuidTable is NULL, then ASSERT(). If ExtractHandlerGuidTable is NULL, then ASSERT().
@param[out] ExtractHandlerGuidTable A pointer to the array of GUIDs that have been registered through @param[out] ExtractHandlerGuidTable A pointer to the array of GUIDs that have been registered through

59
MdePkg/Library/PeiIoLibCpuIo/IoHighLevel.c
View File

@ -127,7 +127,7 @@ IoAndThenOr8 (
@param EndBit The ordinal of the most significant bit in the bit field. @param EndBit The ordinal of the most significant bit in the bit field.
Range 0..7. Range 0..7.
@return The value read from Port. @return The value read.
**/ **/
UINT8 UINT8
@ -313,6 +313,7 @@ IoBitFieldAndThenOr8 (
operations are serialized. operations are serialized.
If 16-bit I/O port operations are not supported, then ASSERT(). If 16-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 16-bit boundary, then ASSERT().
@param Port The I/O port to write. @param Port The I/O port to write.
@param OrData The value to OR with the read value from the I/O port. @param OrData The value to OR with the read value from the I/O port.
@ -341,6 +342,7 @@ IoOr16 (
are serialized. are serialized.
If 16-bit I/O port operations are not supported, then ASSERT(). If 16-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 16-bit boundary, then ASSERT().
@param Port The I/O port to write. @param Port The I/O port to write.
@param AndData The value to AND with the read value from the I/O port. @param AndData The value to AND with the read value from the I/O port.
@ -370,6 +372,7 @@ IoAnd16 (
I/O read and write operations are serialized. I/O read and write operations are serialized.
If 16-bit I/O port operations are not supported, then ASSERT(). If 16-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 16-bit boundary, then ASSERT().
@param Port The I/O port to write. @param Port The I/O port to write.
@param AndData The value to AND with the read value from the I/O port. @param AndData The value to AND with the read value from the I/O port.
@ -396,6 +399,7 @@ IoAndThenOr16 (
the StartBit and the EndBit. The value of the bit field is returned. the StartBit and the EndBit. The value of the bit field is returned.
If 16-bit I/O port operations are not supported, then ASSERT(). If 16-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 16-bit boundary, then ASSERT().
If StartBit is greater than 15, then ASSERT(). If StartBit is greater than 15, then ASSERT().
If EndBit is greater than 15, then ASSERT(). If EndBit is greater than 15, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -406,7 +410,7 @@ IoAndThenOr16 (
@param EndBit The ordinal of the most significant bit in the bit field. @param EndBit The ordinal of the most significant bit in the bit field.
Range 0..15. Range 0..15.
@return The value read from Port. @return The value read.
**/ **/
UINT16 UINT16
@ -429,6 +433,7 @@ IoBitFieldRead16 (
left bits in Value are stripped. left bits in Value are stripped.
If 16-bit I/O port operations are not supported, then ASSERT(). If 16-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 16-bit boundary, then ASSERT().
If StartBit is greater than 15, then ASSERT(). If StartBit is greater than 15, then ASSERT().
If EndBit is greater than 15, then ASSERT(). If EndBit is greater than 15, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -469,6 +474,7 @@ IoBitFieldWrite16 (
operations are serialized. Extra left bits in OrData are stripped. operations are serialized. Extra left bits in OrData are stripped.
If 16-bit I/O port operations are not supported, then ASSERT(). If 16-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 16-bit boundary, then ASSERT().
If StartBit is greater than 15, then ASSERT(). If StartBit is greater than 15, then ASSERT().
If EndBit is greater than 15, then ASSERT(). If EndBit is greater than 15, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -509,6 +515,7 @@ IoBitFieldOr16 (
are serialized. Extra left bits in AndData are stripped. are serialized. Extra left bits in AndData are stripped.
If 16-bit I/O port operations are not supported, then ASSERT(). If 16-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 16-bit boundary, then ASSERT().
If StartBit is greater than 15, then ASSERT(). If StartBit is greater than 15, then ASSERT().
If EndBit is greater than 15, then ASSERT(). If EndBit is greater than 15, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -551,6 +558,7 @@ IoBitFieldAnd16 (
AndData and OrData are stripped. AndData and OrData are stripped.
If 16-bit I/O port operations are not supported, then ASSERT(). If 16-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 16-bit boundary, then ASSERT().
If StartBit is greater than 15, then ASSERT(). If StartBit is greater than 15, then ASSERT().
If EndBit is greater than 15, then ASSERT(). If EndBit is greater than 15, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -593,6 +601,7 @@ IoBitFieldAndThenOr16 (
operations are serialized. operations are serialized.
If 32-bit I/O port operations are not supported, then ASSERT(). If 32-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 32-bit boundary, then ASSERT().
@param Port The I/O port to write. @param Port The I/O port to write.
@param OrData The value to OR with the read value from the I/O port. @param OrData The value to OR with the read value from the I/O port.
@ -621,6 +630,7 @@ IoOr32 (
are serialized. are serialized.
If 32-bit I/O port operations are not supported, then ASSERT(). If 32-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 32-bit boundary, then ASSERT().
@param Port The I/O port to write. @param Port The I/O port to write.
@param AndData The value to AND with the read value from the I/O port. @param AndData The value to AND with the read value from the I/O port.
@ -650,6 +660,7 @@ IoAnd32 (
I/O read and write operations are serialized. I/O read and write operations are serialized.
If 32-bit I/O port operations are not supported, then ASSERT(). If 32-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 32-bit boundary, then ASSERT().
@param Port The I/O port to write. @param Port The I/O port to write.
@param AndData The value to AND with the read value from the I/O port. @param AndData The value to AND with the read value from the I/O port.
@ -676,6 +687,7 @@ IoAndThenOr32 (
the StartBit and the EndBit. The value of the bit field is returned. the StartBit and the EndBit. The value of the bit field is returned.
If 32-bit I/O port operations are not supported, then ASSERT(). If 32-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 32-bit boundary, then ASSERT().
If StartBit is greater than 31, then ASSERT(). If StartBit is greater than 31, then ASSERT().
If EndBit is greater than 31, then ASSERT(). If EndBit is greater than 31, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -686,7 +698,7 @@ IoAndThenOr32 (
@param EndBit The ordinal of the most significant bit in the bit field. @param EndBit The ordinal of the most significant bit in the bit field.
Range 0..31. Range 0..31.
@return The value read from Port. @return The value read.
**/ **/
UINT32 UINT32
@ -709,6 +721,7 @@ IoBitFieldRead32 (
left bits in Value are stripped. left bits in Value are stripped.
If 32-bit I/O port operations are not supported, then ASSERT(). If 32-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 32-bit boundary, then ASSERT().
If StartBit is greater than 31, then ASSERT(). If StartBit is greater than 31, then ASSERT().
If EndBit is greater than 31, then ASSERT(). If EndBit is greater than 31, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -749,6 +762,7 @@ IoBitFieldWrite32 (
operations are serialized. Extra left bits in OrData are stripped. operations are serialized. Extra left bits in OrData are stripped.
If 32-bit I/O port operations are not supported, then ASSERT(). If 32-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 32-bit boundary, then ASSERT().
If StartBit is greater than 31, then ASSERT(). If StartBit is greater than 31, then ASSERT().
If EndBit is greater than 31, then ASSERT(). If EndBit is greater than 31, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -789,6 +803,7 @@ IoBitFieldOr32 (
are serialized. Extra left bits in AndData are stripped. are serialized. Extra left bits in AndData are stripped.
If 32-bit I/O port operations are not supported, then ASSERT(). If 32-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 32-bit boundary, then ASSERT().
If StartBit is greater than 31, then ASSERT(). If StartBit is greater than 31, then ASSERT().
If EndBit is greater than 31, then ASSERT(). If EndBit is greater than 31, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -831,6 +846,7 @@ IoBitFieldAnd32 (
AndData and OrData are stripped. AndData and OrData are stripped.
If 32-bit I/O port operations are not supported, then ASSERT(). If 32-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 32-bit boundary, then ASSERT().
If StartBit is greater than 31, then ASSERT(). If StartBit is greater than 31, then ASSERT().
If EndBit is greater than 31, then ASSERT(). If EndBit is greater than 31, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -873,6 +889,7 @@ IoBitFieldAndThenOr32 (
operations are serialized. operations are serialized.
If 64-bit I/O port operations are not supported, then ASSERT(). If 64-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 64-bit boundary, then ASSERT().
@param Port The I/O port to write. @param Port The I/O port to write.
@param OrData The value to OR with the read value from the I/O port. @param OrData The value to OR with the read value from the I/O port.
@ -901,6 +918,7 @@ IoOr64 (
are serialized. are serialized.
If 64-bit I/O port operations are not supported, then ASSERT(). If 64-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 64-bit boundary, then ASSERT().
@param Port The I/O port to write. @param Port The I/O port to write.
@param AndData The value to AND with the read value from the I/O port. @param AndData The value to AND with the read value from the I/O port.
@ -930,6 +948,7 @@ IoAnd64 (
I/O read and write operations are serialized. I/O read and write operations are serialized.
If 64-bit I/O port operations are not supported, then ASSERT(). If 64-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 64-bit boundary, then ASSERT().
@param Port The I/O port to write. @param Port The I/O port to write.
@param AndData The value to AND with the read value from the I/O port. @param AndData The value to AND with the read value from the I/O port.
@ -956,6 +975,7 @@ IoAndThenOr64 (
the StartBit and the EndBit. The value of the bit field is returned. the StartBit and the EndBit. The value of the bit field is returned.
If 64-bit I/O port operations are not supported, then ASSERT(). If 64-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 64-bit boundary, then ASSERT().
If StartBit is greater than 63, then ASSERT(). If StartBit is greater than 63, then ASSERT().
If EndBit is greater than 63, then ASSERT(). If EndBit is greater than 63, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -989,6 +1009,7 @@ IoBitFieldRead64 (
left bits in Value are stripped. left bits in Value are stripped.
If 64-bit I/O port operations are not supported, then ASSERT(). If 64-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 64-bit boundary, then ASSERT().
If StartBit is greater than 63, then ASSERT(). If StartBit is greater than 63, then ASSERT().
If EndBit is greater than 63, then ASSERT(). If EndBit is greater than 63, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -1029,6 +1050,7 @@ IoBitFieldWrite64 (
operations are serialized. Extra left bits in OrData are stripped. operations are serialized. Extra left bits in OrData are stripped.
If 64-bit I/O port operations are not supported, then ASSERT(). If 64-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 64-bit boundary, then ASSERT().
If StartBit is greater than 63, then ASSERT(). If StartBit is greater than 63, then ASSERT().
If EndBit is greater than 63, then ASSERT(). If EndBit is greater than 63, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -1069,6 +1091,7 @@ IoBitFieldOr64 (
are serialized. Extra left bits in AndData are stripped. are serialized. Extra left bits in AndData are stripped.
If 64-bit I/O port operations are not supported, then ASSERT(). If 64-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 64-bit boundary, then ASSERT().
If StartBit is greater than 63, then ASSERT(). If StartBit is greater than 63, then ASSERT().
If EndBit is greater than 63, then ASSERT(). If EndBit is greater than 63, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -1111,6 +1134,7 @@ IoBitFieldAnd64 (
AndData and OrData are stripped. AndData and OrData are stripped.
If 64-bit I/O port operations are not supported, then ASSERT(). If 64-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 64-bit boundary, then ASSERT().
If StartBit is greater than 63, then ASSERT(). If StartBit is greater than 63, then ASSERT().
If EndBit is greater than 63, then ASSERT(). If EndBit is greater than 63, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -1435,6 +1459,7 @@ MmioBitFieldAndThenOr8 (
all MMIO read and write operations are serialized. all MMIO read and write operations are serialized.
If 16-bit MMIO register operations are not supported, then ASSERT(). If 16-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 16-bit boundary, then ASSERT().
@param Address The MMIO register to write. @param Address The MMIO register to write.
@param OrData The value to OR with the read value from the MMIO register. @param OrData The value to OR with the read value from the MMIO register.
@ -1463,6 +1488,7 @@ MmioOr16 (
read and write operations are serialized. read and write operations are serialized.
If 16-bit MMIO register operations are not supported, then ASSERT(). If 16-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 16-bit boundary, then ASSERT().
@param Address The MMIO register to write. @param Address The MMIO register to write.
@param AndData The value to AND with the read value from the MMIO register. @param AndData The value to AND with the read value from the MMIO register.
@ -1492,7 +1518,7 @@ MmioAnd16 (
must guarantee that all MMIO read and write operations are serialized. must guarantee that all MMIO read and write operations are serialized.
If 16-bit MMIO register operations are not supported, then ASSERT(). If 16-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 16-bit boundary, then ASSERT().
@param Address The MMIO register to write. @param Address The MMIO register to write.
@param AndData The value to AND with the read value from the MMIO register. @param AndData The value to AND with the read value from the MMIO register.
@ -1519,6 +1545,7 @@ MmioAndThenOr16 (
the StartBit and the EndBit. The value of the bit field is returned. the StartBit and the EndBit. The value of the bit field is returned.
If 16-bit MMIO register operations are not supported, then ASSERT(). If 16-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 16-bit boundary, then ASSERT().
If StartBit is greater than 15, then ASSERT(). If StartBit is greater than 15, then ASSERT().
If EndBit is greater than 15, then ASSERT(). If EndBit is greater than 15, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -1529,7 +1556,7 @@ MmioAndThenOr16 (
@param EndBit The ordinal of the most significant bit in the bit field. @param EndBit The ordinal of the most significant bit in the bit field.
Range 0..15. Range 0..15.
@return The value read from Address. @return The value read.
**/ **/
UINT16 UINT16
@ -1551,6 +1578,7 @@ MmioBitFieldRead16 (
MMIO register are preserved. The new value of the 16-bit register is returned. MMIO register are preserved. The new value of the 16-bit register is returned.
If 16-bit MMIO register operations are not supported, then ASSERT(). If 16-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 16-bit boundary, then ASSERT().
If StartBit is greater than 15, then ASSERT(). If StartBit is greater than 15, then ASSERT().
If EndBit is greater than 15, then ASSERT(). If EndBit is greater than 15, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -1592,6 +1620,7 @@ MmioBitFieldWrite16 (
are stripped. are stripped.
If 16-bit MMIO register operations are not supported, then ASSERT(). If 16-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 16-bit boundary, then ASSERT().
If StartBit is greater than 15, then ASSERT(). If StartBit is greater than 15, then ASSERT().
If EndBit is greater than 15, then ASSERT(). If EndBit is greater than 15, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -1633,6 +1662,7 @@ MmioBitFieldOr16 (
stripped. stripped.
If 16-bit MMIO register operations are not supported, then ASSERT(). If 16-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 16-bit boundary, then ASSERT().
If StartBit is greater than 15, then ASSERT(). If StartBit is greater than 15, then ASSERT().
If EndBit is greater than 15, then ASSERT(). If EndBit is greater than 15, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -1675,6 +1705,7 @@ MmioBitFieldAnd16 (
serialized. Extra left bits in both AndData and OrData are stripped. serialized. Extra left bits in both AndData and OrData are stripped.
If 16-bit MMIO register operations are not supported, then ASSERT(). If 16-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 16-bit boundary, then ASSERT().
If StartBit is greater than 15, then ASSERT(). If StartBit is greater than 15, then ASSERT().
If EndBit is greater than 15, then ASSERT(). If EndBit is greater than 15, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -1717,6 +1748,7 @@ MmioBitFieldAndThenOr16 (
all MMIO read and write operations are serialized. all MMIO read and write operations are serialized.
If 32-bit MMIO register operations are not supported, then ASSERT(). If 32-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 32-bit boundary, then ASSERT().
@param Address The MMIO register to write. @param Address The MMIO register to write.
@param OrData The value to OR with the read value from the MMIO register. @param OrData The value to OR with the read value from the MMIO register.
@ -1745,6 +1777,7 @@ MmioOr32 (
read and write operations are serialized. read and write operations are serialized.
If 32-bit MMIO register operations are not supported, then ASSERT(). If 32-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 32-bit boundary, then ASSERT().
@param Address The MMIO register to write. @param Address The MMIO register to write.
@param AndData The value to AND with the read value from the MMIO register. @param AndData The value to AND with the read value from the MMIO register.
@ -1774,7 +1807,7 @@ MmioAnd32 (
must guarantee that all MMIO read and write operations are serialized. must guarantee that all MMIO read and write operations are serialized.
If 32-bit MMIO register operations are not supported, then ASSERT(). If 32-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 32-bit boundary, then ASSERT().
@param Address The MMIO register to write. @param Address The MMIO register to write.
@param AndData The value to AND with the read value from the MMIO register. @param AndData The value to AND with the read value from the MMIO register.
@ -1801,6 +1834,7 @@ MmioAndThenOr32 (
the StartBit and the EndBit. The value of the bit field is returned. the StartBit and the EndBit. The value of the bit field is returned.
If 32-bit MMIO register operations are not supported, then ASSERT(). If 32-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 32-bit boundary, then ASSERT().
If StartBit is greater than 31, then ASSERT(). If StartBit is greater than 31, then ASSERT().
If EndBit is greater than 31, then ASSERT(). If EndBit is greater than 31, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -1833,6 +1867,7 @@ MmioBitFieldRead32 (
MMIO register are preserved. The new value of the 32-bit register is returned. MMIO register are preserved. The new value of the 32-bit register is returned.
If 32-bit MMIO register operations are not supported, then ASSERT(). If 32-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 32-bit boundary, then ASSERT().
If StartBit is greater than 31, then ASSERT(). If StartBit is greater than 31, then ASSERT().
If EndBit is greater than 31, then ASSERT(). If EndBit is greater than 31, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -1874,6 +1909,7 @@ MmioBitFieldWrite32 (
are stripped. are stripped.
If 32-bit MMIO register operations are not supported, then ASSERT(). If 32-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 32-bit boundary, then ASSERT().
If StartBit is greater than 31, then ASSERT(). If StartBit is greater than 31, then ASSERT().
If EndBit is greater than 31, then ASSERT(). If EndBit is greater than 31, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -1915,6 +1951,7 @@ MmioBitFieldOr32 (
stripped. stripped.
If 32-bit MMIO register operations are not supported, then ASSERT(). If 32-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 32-bit boundary, then ASSERT().
If StartBit is greater than 31, then ASSERT(). If StartBit is greater than 31, then ASSERT().
If EndBit is greater than 31, then ASSERT(). If EndBit is greater than 31, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -1957,6 +1994,7 @@ MmioBitFieldAnd32 (
serialized. Extra left bits in both AndData and OrData are stripped. serialized. Extra left bits in both AndData and OrData are stripped.
If 32-bit MMIO register operations are not supported, then ASSERT(). If 32-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 32-bit boundary, then ASSERT().
If StartBit is greater than 31, then ASSERT(). If StartBit is greater than 31, then ASSERT().
If EndBit is greater than 31, then ASSERT(). If EndBit is greater than 31, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -1999,6 +2037,7 @@ MmioBitFieldAndThenOr32 (
all MMIO read and write operations are serialized. all MMIO read and write operations are serialized.
If 64-bit MMIO register operations are not supported, then ASSERT(). If 64-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 64-bit boundary, then ASSERT().
@param Address The MMIO register to write. @param Address The MMIO register to write.
@param OrData The value to OR with the read value from the MMIO register. @param OrData The value to OR with the read value from the MMIO register.
@ -2027,6 +2066,7 @@ MmioOr64 (
read and write operations are serialized. read and write operations are serialized.
If 64-bit MMIO register operations are not supported, then ASSERT(). If 64-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 64-bit boundary, then ASSERT().
@param Address The MMIO register to write. @param Address The MMIO register to write.
@param AndData The value to AND with the read value from the MMIO register. @param AndData The value to AND with the read value from the MMIO register.
@ -2056,7 +2096,7 @@ MmioAnd64 (
must guarantee that all MMIO read and write operations are serialized. must guarantee that all MMIO read and write operations are serialized.
If 64-bit MMIO register operations are not supported, then ASSERT(). If 64-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 64-bit boundary, then ASSERT().
@param Address The MMIO register to write. @param Address The MMIO register to write.
@param AndData The value to AND with the read value from the MMIO register. @param AndData The value to AND with the read value from the MMIO register.
@ -2083,6 +2123,7 @@ MmioAndThenOr64 (
the StartBit and the EndBit. The value of the bit field is returned. the StartBit and the EndBit. The value of the bit field is returned.
If 64-bit MMIO register operations are not supported, then ASSERT(). If 64-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 64-bit boundary, then ASSERT().
If StartBit is greater than 63, then ASSERT(). If StartBit is greater than 63, then ASSERT().
If EndBit is greater than 63, then ASSERT(). If EndBit is greater than 63, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -2115,6 +2156,7 @@ MmioBitFieldRead64 (
MMIO register are preserved. The new value of the 64-bit register is returned. MMIO register are preserved. The new value of the 64-bit register is returned.
If 64-bit MMIO register operations are not supported, then ASSERT(). If 64-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 64-bit boundary, then ASSERT().
If StartBit is greater than 63, then ASSERT(). If StartBit is greater than 63, then ASSERT().
If EndBit is greater than 63, then ASSERT(). If EndBit is greater than 63, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -2156,6 +2198,7 @@ MmioBitFieldWrite64 (
are stripped. are stripped.
If 64-bit MMIO register operations are not supported, then ASSERT(). If 64-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 64-bit boundary, then ASSERT().
If StartBit is greater than 63, then ASSERT(). If StartBit is greater than 63, then ASSERT().
If EndBit is greater than 63, then ASSERT(). If EndBit is greater than 63, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -2197,6 +2240,7 @@ MmioBitFieldOr64 (
stripped. stripped.
If 64-bit MMIO register operations are not supported, then ASSERT(). If 64-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 64-bit boundary, then ASSERT().
If StartBit is greater than 63, then ASSERT(). If StartBit is greater than 63, then ASSERT().
If EndBit is greater than 63, then ASSERT(). If EndBit is greater than 63, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().
@ -2239,6 +2283,7 @@ MmioBitFieldAnd64 (
serialized. Extra left bits in both AndData and OrData are stripped. serialized. Extra left bits in both AndData and OrData are stripped.
If 64-bit MMIO register operations are not supported, then ASSERT(). If 64-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 64-bit boundary, then ASSERT().
If StartBit is greater than 63, then ASSERT(). If StartBit is greater than 63, then ASSERT().
If EndBit is greater than 63, then ASSERT(). If EndBit is greater than 63, then ASSERT().
If EndBit is less than StartBit, then ASSERT(). If EndBit is less than StartBit, then ASSERT().

34
MdePkg/Library/PeiIoLibCpuIo/IoLib.c
View File

@ -31,7 +31,7 @@
@param Port The I/O port to read. @param Port The I/O port to read.
@return The value read from Port. @return The value read.
**/ **/
UINT8 UINT8
@ -91,10 +91,11 @@ IoWrite8 (
serialized. serialized.
If 16-bit I/O port operations are not supported, then ASSERT(). If 16-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 16-bit boundary, then ASSERT().
@param Port The I/O port to read. @param Port The I/O port to read.
@return The value read from Port. @return The value read.
**/ **/
UINT16 UINT16
@ -124,6 +125,7 @@ IoRead16 (
operations are serialized. operations are serialized.
If 16-bit I/O port operations are not supported, then ASSERT(). If 16-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 16-bit boundary, then ASSERT().
@param Port The I/O port to write. @param Port The I/O port to write.
@param Value The value to write to the I/O port. @param Value The value to write to the I/O port.
@ -160,10 +162,11 @@ IoWrite16 (
serialized. serialized.
If 32-bit I/O port operations are not supported, then ASSERT(). If 32-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 32-bit boundary, then ASSERT().
@param Port The I/O port to read. @param Port The I/O port to read.
@return The value read from Port. @return The value read.
**/ **/
UINT32 UINT32
@ -193,6 +196,7 @@ IoRead32 (
operations are serialized. operations are serialized.
If 32-bit I/O port operations are not supported, then ASSERT(). If 32-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 32-bit boundary, then ASSERT().
@param Port The I/O port to write. @param Port The I/O port to write.
@param Value The value to write to the I/O port. @param Value The value to write to the I/O port.
@ -229,10 +233,11 @@ IoWrite32 (
serialized. serialized.
If 64-bit I/O port operations are not supported, then ASSERT(). If 64-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 64-bit boundary, then ASSERT().
@param Port The I/O port to read. @param Port The I/O port to read.
@return The value read from Port. @return The value read.
**/ **/
UINT64 UINT64
@ -262,6 +267,7 @@ IoRead64 (
operations are serialized. operations are serialized.
If 64-bit I/O port operations are not supported, then ASSERT(). If 64-bit I/O port operations are not supported, then ASSERT().
If Port is not aligned on a 64-bit boundary, then ASSERT().
@param Port The I/O port to write. @param Port The I/O port to write.
@param Value The value to write to the I/O port. @param Value The value to write to the I/O port.
@ -301,7 +307,7 @@ IoWrite64 (
@param Address The MMIO register to read. @param Address The MMIO register to read.
@return The value read from Port. @return The value read.
**/ **/
UINT8 UINT8
@ -332,7 +338,6 @@ MmioRead8 (
@param Address The MMIO register to write. @param Address The MMIO register to write.
@param Value The value to write to the MMIO register. @param Value The value to write to the MMIO register.
@return The Value written back to Mmio register.
**/ **/
UINT8 UINT8
EFIAPI EFIAPI
@ -360,10 +365,11 @@ MmioWrite8 (
operations are serialized. operations are serialized.
If 16-bit MMIO register operations are not supported, then ASSERT(). If 16-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 16-bit boundary, then ASSERT().
@param Address The MMIO register to read. @param Address The MMIO register to read.
@return The value read from Address. @return The value read.
**/ **/
UINT16 UINT16
@ -394,12 +400,11 @@ MmioRead16 (
and write operations are serialized. and write operations are serialized.
If 16-bit MMIO register operations are not supported, then ASSERT(). If 16-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 16-bit boundary, then ASSERT().
@param Address The MMIO register to write. @param Address The MMIO register to write.
@param Value The value to write to the MMIO register. @param Value The value to write to the MMIO register.
@return The Value written back to Mmio register
**/ **/
UINT16 UINT16
EFIAPI EFIAPI
@ -430,10 +435,11 @@ MmioWrite16 (
operations are serialized. operations are serialized.
If 32-bit MMIO register operations are not supported, then ASSERT(). If 32-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 32-bit boundary, then ASSERT().
@param Address The MMIO register to read. @param Address The MMIO register to read.
@return The value read from Address. @return The value read.
**/ **/
UINT32 UINT32
@ -464,12 +470,11 @@ MmioRead32 (
and write operations are serialized. and write operations are serialized.
If 32-bit MMIO register operations are not supported, then ASSERT(). If 32-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 32-bit boundary, then ASSERT().
@param Address The MMIO register to write. @param Address The MMIO register to write.
@param Value The value to write to the MMIO register. @param Value The value to write to the MMIO register.
@return The Value written back to Mmio register
**/ **/
UINT32 UINT32
EFIAPI EFIAPI
@ -500,10 +505,11 @@ MmioWrite32 (
operations are serialized. operations are serialized.
If 64-bit MMIO register operations are not supported, then ASSERT(). If 64-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 64-bit boundary, then ASSERT().
@param Address The MMIO register to read. @param Address The MMIO register to read.
@return The value read from Address. @return The value read.
**/ **/
UINT64 UINT64
@ -534,11 +540,11 @@ MmioRead64 (
and write operations are serialized. and write operations are serialized.
If 64-bit MMIO register operations are not supported, then ASSERT(). If 64-bit MMIO register operations are not supported, then ASSERT().
If Address is not aligned on a 64-bit boundary, then ASSERT().
@param Address The MMIO register to write. @param Address The MMIO register to write.
@param Value The value to write to the MMIO register. @param Value The value to write to the MMIO register.
@return The Value written back to Mmio register
**/ **/
UINT64 UINT64
EFIAPI EFIAPI

32
MdePkg/Library/PeiIoLibCpuIo/IoLibMmioBuffer.c
View File

@ -33,10 +33,10 @@
@param StartAddress Starting address for the MMIO region to be copied from. @param StartAddress Starting address for the MMIO region to be copied from.
@param Length Size in bytes of the copy. @param Length The size, in bytes, of Buffer.
@param Buffer Pointer to a system memory buffer receiving the data read. @param Buffer Pointer to a system memory buffer receiving the data read.
@return Pointer to a system memory buffer receiving the data read. @return Buffer
**/ **/
UINT8 * UINT8 *
@ -77,10 +77,10 @@ MmioReadBuffer8 (
If Buffer is not aligned on a 16-bit boundary, then ASSERT(). If Buffer is not aligned on a 16-bit boundary, then ASSERT().
@param StartAddress Starting address for the MMIO region to be copied from. @param StartAddress Starting address for the MMIO region to be copied from.
@param Length Size in bytes of the copy. @param Length The size, in bytes, of Buffer.
@param Buffer Pointer to a system memory buffer receiving the data read. @param Buffer Pointer to a system memory buffer receiving the data read.
@return Pointer to a system memory buffer receiving the data read. @return Buffer
**/ **/
UINT16 * UINT16 *
@ -128,10 +128,10 @@ MmioReadBuffer16 (
If Buffer is not aligned on a 32-bit boundary, then ASSERT(). If Buffer is not aligned on a 32-bit boundary, then ASSERT().
@param StartAddress Starting address for the MMIO region to be copied from. @param StartAddress Starting address for the MMIO region to be copied from.
@param Length Size in bytes of the copy. @param Length The size, in bytes, of Buffer.
@param Buffer Pointer to a system memory buffer receiving the data read. @param Buffer Pointer to a system memory buffer receiving the data read.
@return Pointer to a system memory buffer receiving the data read. @return Buffer
**/ **/
UINT32 * UINT32 *
@ -179,10 +179,10 @@ MmioReadBuffer32 (
If Buffer is not aligned on a 64-bit boundary, then ASSERT(). If Buffer is not aligned on a 64-bit boundary, then ASSERT().
@param StartAddress Starting address for the MMIO region to be copied from. @param StartAddress Starting address for the MMIO region to be copied from.
@param Length Size in bytes of the copy. @param Length The size, in bytes, of Buffer.
@param Buffer Pointer to a system memory buffer receiving the data read. @param Buffer Pointer to a system memory buffer receiving the data read.
@return Pointer to a system memory buffer receiving the data read. @return Buffer
**/ **/
UINT64 * UINT64 *
@ -227,10 +227,10 @@ MmioReadBuffer64 (
@param StartAddress Starting address for the MMIO region to be copied to. @param StartAddress Starting address for the MMIO region to be copied to.
@param Length Size in bytes of the copy. @param Length The size, in bytes, of Buffer.
@param Buffer Pointer to a system memory buffer containing the data to write. @param Buffer Pointer to a system memory buffer containing the data to write.
@return Pointer to a system memory buffer containing the data to write. @return Size in bytes of the copy.
**/ **/
UINT8 * UINT8 *
@ -273,10 +273,10 @@ MmioWriteBuffer8 (
If Buffer is not aligned on a 16-bit boundary, then ASSERT(). If Buffer is not aligned on a 16-bit boundary, then ASSERT().
@param StartAddress Starting address for the MMIO region to be copied to. @param StartAddress Starting address for the MMIO region to be copied to.
@param Length Size in bytes of the copy. @param Length The size, in bytes, of Buffer.
@param Buffer Pointer to a system memory buffer containing the data to write. @param Buffer Pointer to a system memory buffer containing the data to write.
@return Pointer to a system memory buffer containing the data to write. @return Size in bytes of the copy.
**/ **/
UINT16 * UINT16 *
@ -327,10 +327,10 @@ MmioWriteBuffer16 (
If Buffer is not aligned on a 32-bit boundary, then ASSERT(). If Buffer is not aligned on a 32-bit boundary, then ASSERT().
@param StartAddress Starting address for the MMIO region to be copied to. @param StartAddress Starting address for the MMIO region to be copied to.
@param Length Size in bytes of the copy. @param Length The size, in bytes, of Buffer.
@param Buffer Pointer to a system memory buffer containing the data to write. @param Buffer Pointer to a system memory buffer containing the data to write.
@return Pointer to a system memory buffer containing the data to write. @return Size in bytes of the copy.
**/ **/
UINT32 * UINT32 *
@ -380,10 +380,10 @@ MmioWriteBuffer32 (
If Buffer is not aligned on a 64-bit boundary, then ASSERT(). If Buffer is not aligned on a 64-bit boundary, then ASSERT().
@param StartAddress Starting address for the MMIO region to be copied to. @param StartAddress Starting address for the MMIO region to be copied to.
@param Length Size in bytes of the copy. @param Length The size, in bytes, of Buffer.
@param Buffer Pointer to a system memory buffer containing the data to write. @param Buffer Pointer to a system memory buffer containing the data to write.
@return Pointer to a system memory buffer containing the data to write. @return Size in bytes of the copy.
**/ **/
UINT64 * UINT64 *