From 2281e7a9c32eeb32b833daf6b33ad26e437551da Mon Sep 17 00:00:00 2001 From: gikidy Date: Wed, 10 Dec 2008 06:13:43 +0000 Subject: Synchronize the h files with c files. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@6967 6f19259b-4bc3-4df7-8a09-765794883524 --- MdePkg/Library/BaseIoLibIntrinsic/IoLibGcc.c | 125 +++++++++++++++++++++++---- 1 file changed, 108 insertions(+), 17 deletions(-) (limited to 'MdePkg/Library/BaseIoLibIntrinsic/IoLibGcc.c') diff --git a/MdePkg/Library/BaseIoLibIntrinsic/IoLibGcc.c b/MdePkg/Library/BaseIoLibIntrinsic/IoLibGcc.c index 1377650042..0cca85ee24 100644 --- a/MdePkg/Library/BaseIoLibIntrinsic/IoLibGcc.c +++ b/MdePkg/Library/BaseIoLibIntrinsic/IoLibGcc.c @@ -35,7 +35,7 @@ @param Address The MMIO register to read. - @return The value read from Address. + @return The value read. **/ UINT8 @@ -58,10 +58,9 @@ MmioRead8 ( @param Address The MMIO register to write. @param Value The value to write to the MMIO register. + + @return Value. - @return The value written to the Mmio. It equals to the input - Value instead of the actual value read back from the - Mmio. **/ UINT8 EFIAPI @@ -81,10 +80,11 @@ MmioWrite8 ( operations are serialized. 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. - @return The value read from Address. + @return The value read. **/ UINT16 @@ -105,13 +105,13 @@ MmioRead16 ( and write operations are serialized. 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 Value The value to write to the MMIO register. + + @return Value. - @return The value written to the Mmio. It equals to the input - Value instead of the actual value read back from the - Mmio. **/ UINT16 EFIAPI @@ -132,10 +132,11 @@ MmioWrite16 ( operations are serialized. 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. - @return The value read from Address. + @return The value read. **/ UINT32 @@ -156,13 +157,13 @@ MmioRead32 ( and write operations are serialized. 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 Value The value to write to the MMIO register. + + @return Value. - @return The value written to the Mmio. It equals to the input - Value instead of the actual value read back from the - Mmio. **/ UINT32 EFIAPI @@ -183,10 +184,11 @@ MmioWrite32 ( operations are serialized. 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. - @return The value read from Address. + @return The value read. **/ UINT64 @@ -207,13 +209,11 @@ MmioRead64 ( and write operations are serialized. 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 Value The value to write to the MMIO register. - @return The value written to the Mmio. It equals to the input - Value instead of the actual value read back from the - Mmio. **/ UINT64 EFIAPI @@ -243,6 +243,20 @@ MmioWrite64 ( **/ __inline__ +/** + Reads an 8-bit I/O port. + + Reads the 8-bit I/O port specified by Port. The 8-bit read value is returned. + This function must guarantee that all I/O read and write operations are + serialized. + + If 8-bit I/O port operations are not supported, then ASSERT(). + + @param Port The I/O port to read. + + @return The value read. + +**/ UINT8 EFIAPI IoRead8 ( @@ -273,6 +287,21 @@ IoRead8 ( **/ __inline__ +/** + Writes an 8-bit I/O port. + + Writes the 8-bit I/O port specified by Port with the value specified by Value + and returns Value. This function must guarantee that all I/O read and write + operations are serialized. + + If 8-bit I/O port operations are not supported, then ASSERT(). + + @param Port The I/O port to write. + @param Value The value to write to the I/O port. + + @return The value written the I/O port. + +**/ UINT8 EFIAPI IoWrite8 ( @@ -299,6 +328,21 @@ IoWrite8 ( **/ __inline__ +/** + Reads a 16-bit I/O port. + + Reads the 16-bit I/O port specified by Port. The 16-bit read value is returned. + This function must guarantee that all I/O read and write operations are + serialized. + + 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. + + @return The value read. + +**/ UINT16 EFIAPI IoRead16 ( @@ -330,6 +374,22 @@ IoRead16 ( **/ __inline__ +/** + Writes a 16-bit I/O port. + + Writes the 16-bit I/O port specified by Port with the value specified by Value + and returns Value. This function must guarantee that all I/O read and write + operations are serialized. + + 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 Value The value to write to the I/O port. + + @return The value written the I/O port. + +**/ UINT16 EFIAPI IoWrite16 ( @@ -357,6 +417,21 @@ IoWrite16 ( **/ __inline__ +/** + Reads a 32-bit I/O port. + + Reads the 32-bit I/O port specified by Port. The 32-bit read value is returned. + This function must guarantee that all I/O read and write operations are + serialized. + + 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. + + @return The value read. + +**/ UINT32 EFIAPI IoRead32 ( @@ -388,11 +463,27 @@ IoRead32 ( **/ __inline__ +/** + Writes a 32-bit I/O port. + + Writes the 32-bit I/O port specified by Port with the value specified by Value + and returns Value. This function must guarantee that all I/O read and write + operations are serialized. + + 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 Value The value to write to the I/O port. + + @return The value written the I/O port. + +**/ UINT32 EFIAPI IoWrite32 ( IN UINTN Port, - IN UINT32 Value + IN UINT32 Value ) { ASSERT ((Port & 3) == 0); -- cgit v1.2.3