tyler.durden/audk
1
0
Fork 0
mirror of https://github.com/acidanthera/audk.git synced 2025-07-25 14:44:28 +02:00
Code Issues Packages Projects Releases Wiki Activity

Synchronize MdePkg h files to Library/Base* c files.

Browse Source 
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@6984 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
gikidy 2008-12-11 04:45:23 +00:00
parent 2fc60b7038
commit efb2311707
26 changed files with 277 additions and 186 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
MdePkg/Include/Library/BaseLib.h
View File

@ -1817,7 +1817,7 @@ GetPowerOfTwo64 (
@param Value A 16-bit unsigned value. @param Value A 16-bit unsigned value.
@return The byte swapped value. @return The byte swapped Value.
**/ **/
UINT16 UINT16
@ -1836,7 +1836,7 @@ SwapBytes16 (
@param Value A 32-bit unsigned value. @param Value A 32-bit unsigned value.
@return The byte swapped value. @return The byte swapped Value.
**/ **/
UINT32 UINT32
@ -1855,7 +1855,7 @@ SwapBytes32 (
@param Value A 64-bit unsigned value. @param Value A 64-bit unsigned value.
@return The byte swapped value. @return The byte swapped Value.
**/ **/
UINT64 UINT64

3
MdePkg/Library/BaseCacheMaintenanceLib/EbcCache.c
View File

@ -19,9 +19,6 @@
Invalidates the entire instruction cache in cache coherency domain of the Invalidates the entire instruction cache in cache coherency domain of the
calling CPU. calling CPU.
Invalidates the entire instruction cache in cache coherency domain of the
calling CPU.
**/ **/
VOID VOID
EFIAPI EFIAPI

3
MdePkg/Library/BaseCacheMaintenanceLib/IpfCache.c
View File

@ -22,9 +22,6 @@
Invalidates the entire instruction cache in cache coherency domain of the Invalidates the entire instruction cache in cache coherency domain of the
calling CPU. calling CPU.
Invalidates the entire instruction cache in cache coherency domain of the
calling CPU.
**/ **/
VOID VOID
EFIAPI EFIAPI

3
MdePkg/Library/BaseCacheMaintenanceLib/X86Cache.c
View File

@ -27,9 +27,6 @@
Invalidates the entire instruction cache in cache coherency domain of the Invalidates the entire instruction cache in cache coherency domain of the
calling CPU. calling CPU.
Invalidates the entire instruction cache in cache coherency domain of the
calling CPU.
**/ **/
VOID VOID
EFIAPI EFIAPI

2
MdePkg/Library/BaseDebugLibNull/DebugLib.c
View File

@ -80,7 +80,7 @@ DebugAssert (
PcdDebugClearMemoryValue, and returns Buffer. PcdDebugClearMemoryValue, and returns Buffer.
If Buffer is NULL, then ASSERT(). If Buffer is NULL, then ASSERT().
If Length is greater than (MAX_ADDRESS -Buffer + 1), then ASSERT(). If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().
@param Buffer Pointer to the target buffer to be filled with PcdDebugClearMemoryValue. @param Buffer Pointer to the target buffer to be filled with PcdDebugClearMemoryValue.
@param Length Number of bytes in Buffer to fill with zeros PcdDebugClearMemoryValue. @param Length Number of bytes in Buffer to fill with zeros PcdDebugClearMemoryValue.

2
MdePkg/Library/BaseDebugLibSerialPort/DebugLib.c
View File

@ -137,7 +137,7 @@ DebugAssert (
PcdDebugClearMemoryValue, and returns Buffer. PcdDebugClearMemoryValue, and returns Buffer.
If Buffer is NULL, then ASSERT(). If Buffer is NULL, then ASSERT().
If Length is greater than (MAX_ADDRESS -Buffer + 1), then ASSERT(). If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().
@param Buffer Pointer to the target buffer to be filled with PcdDebugClearMemoryValue. @param Buffer Pointer to the target buffer to be filled with PcdDebugClearMemoryValue.
@param Length Number of bytes in Buffer to fill with zeros PcdDebugClearMemoryValue. @param Length Number of bytes in Buffer to fill with zeros PcdDebugClearMemoryValue.

2
MdePkg/Library/BaseLib/SwapBytes16.c
View File

@ -26,7 +26,7 @@
@param Value A 16-bit unsigned value. @param Value A 16-bit unsigned value.
@return The byte swapped value. @return The byte swapped Value.
**/ **/
UINT16 UINT16

4
MdePkg/Library/BaseMemoryLib/CompareMemWrapper.c
View File

@ -31,7 +31,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
If all Length bytes of the two buffers are identical, then 0 is returned. Otherwise, the If all Length bytes of the two buffers are identical, then 0 is returned. Otherwise, the
value returned is the first mismatched byte in SourceBuffer subtracted from the first value returned is the first mismatched byte in SourceBuffer subtracted from the first
mismatched byte in DestinationBuffer. mismatched byte in DestinationBuffer.
If Length > 0 and DestinationBuffer is NULL, then ASSERT(). If Length > 0 and DestinationBuffer is NULL, then ASSERT().
If Length > 0 and SourceBuffer is NULL, then ASSERT(). If Length > 0 and SourceBuffer is NULL, then ASSERT().
If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT(). If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT().
@ -44,7 +44,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
@return 0 All Length bytes of the two buffers are identical. @return 0 All Length bytes of the two buffers are identical.
@retval Non-zero The first mismatched byte in SourceBuffer subtracted from the first @retval Non-zero The first mismatched byte in SourceBuffer subtracted from the first
mismatched byte in DestinationBuffer. mismatched byte in DestinationBuffer.
**/ **/
INTN INTN
EFIAPI EFIAPI

24
MdePkg/Library/BaseMemoryLib/CopyMem.c
View File

@ -22,9 +22,9 @@
/** /**
Copy Length bytes from Source to Destination. Copy Length bytes from Source to Destination.
@param Destination Target of copy @param DestinationBuffer Target of copy
@param Source Place to copy from @param SourceBuffer Place to copy from
@param Length Number of bytes to copy @param Length Number of bytes to copy
@return Destination @return Destination
@ -32,8 +32,8 @@
VOID * VOID *
EFIAPI EFIAPI
InternalMemCopyMem ( InternalMemCopyMem (
OUT VOID *Destination, OUT VOID *DestinationBuffer,
IN CONST VOID *Source, IN CONST VOID *SourceBuffer,
IN UINTN Length IN UINTN Length
) )
{ {
@ -45,18 +45,18 @@ InternalMemCopyMem (
volatile UINT8 *Destination8; volatile UINT8 *Destination8;
CONST UINT8 *Source8; CONST UINT8 *Source8;
if (Source > Destination) { if (SourceBuffer > DestinationBuffer) {
Destination8 = (UINT8*)Destination; Destination8 = (UINT8*)DestinationBuffer;
Source8 = (CONST UINT8*)Source; Source8 = (CONST UINT8*)SourceBuffer;
while (Length-- != 0) { while (Length-- != 0) {
*(Destination8++) = *(Source8++); *(Destination8++) = *(Source8++);
} }
} else if (Source < Destination) { } else if (SourceBuffer < DestinationBuffer) {
Destination8 = (UINT8*)Destination + Length; Destination8 = (UINT8*)DestinationBuffer + Length;
Source8 = (CONST UINT8*)Source + Length; Source8 = (CONST UINT8*)SourceBuffer + Length;
while (Length-- != 0) { while (Length-- != 0) {
*(--Destination8) = *(--Source8); *(--Destination8) = *(--Source8);
} }
} }
return Destination; return DestinationBuffer;
} }

6
MdePkg/Library/BaseMemoryLib/SetMem.c
View File

@ -23,9 +23,9 @@
/** /**
Set Buffer to Value for Size bytes. Set Buffer to Value for Size bytes.
@param Buffer Memory to set. @param Buffer Memory to set.
@param Length Number of bytes to set @param Length Number of bytes to set
@param Value Value of the set operation. @param Value Value of the set operation.
@return Buffer @return Buffer

4
MdePkg/Library/BaseMemoryLibMmx/CompareMemWrapper.c
View File

@ -31,7 +31,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
If all Length bytes of the two buffers are identical, then 0 is returned. Otherwise, the If all Length bytes of the two buffers are identical, then 0 is returned. Otherwise, the
value returned is the first mismatched byte in SourceBuffer subtracted from the first value returned is the first mismatched byte in SourceBuffer subtracted from the first
mismatched byte in DestinationBuffer. mismatched byte in DestinationBuffer.
If Length > 0 and DestinationBuffer is NULL, then ASSERT(). If Length > 0 and DestinationBuffer is NULL, then ASSERT().
If Length > 0 and SourceBuffer is NULL, then ASSERT(). If Length > 0 and SourceBuffer is NULL, then ASSERT().
If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT(). If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT().
@ -44,7 +44,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
@return 0 All Length bytes of the two buffers are identical. @return 0 All Length bytes of the two buffers are identical.
@retval Non-zero The first mismatched byte in SourceBuffer subtracted from the first @retval Non-zero The first mismatched byte in SourceBuffer subtracted from the first
mismatched byte in DestinationBuffer. mismatched byte in DestinationBuffer.
**/ **/
INTN INTN
EFIAPI EFIAPI

4
MdePkg/Library/BaseMemoryLibOptDxe/CompareMemWrapper.c
View File

@ -31,7 +31,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
If all Length bytes of the two buffers are identical, then 0 is returned. Otherwise, the If all Length bytes of the two buffers are identical, then 0 is returned. Otherwise, the
value returned is the first mismatched byte in SourceBuffer subtracted from the first value returned is the first mismatched byte in SourceBuffer subtracted from the first
mismatched byte in DestinationBuffer. mismatched byte in DestinationBuffer.
If Length > 0 and DestinationBuffer is NULL, then ASSERT(). If Length > 0 and DestinationBuffer is NULL, then ASSERT().
If Length > 0 and SourceBuffer is NULL, then ASSERT(). If Length > 0 and SourceBuffer is NULL, then ASSERT().
If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT(). If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT().
@ -44,7 +44,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
@return 0 All Length bytes of the two buffers are identical. @return 0 All Length bytes of the two buffers are identical.
@retval Non-zero The first mismatched byte in SourceBuffer subtracted from the first @retval Non-zero The first mismatched byte in SourceBuffer subtracted from the first
mismatched byte in DestinationBuffer. mismatched byte in DestinationBuffer.
**/ **/
INTN INTN
EFIAPI EFIAPI

4
MdePkg/Library/BaseMemoryLibOptPei/CompareMemWrapper.c
View File

@ -32,7 +32,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
If all Length bytes of the two buffers are identical, then 0 is returned. Otherwise, the If all Length bytes of the two buffers are identical, then 0 is returned. Otherwise, the
value returned is the first mismatched byte in SourceBuffer subtracted from the first value returned is the first mismatched byte in SourceBuffer subtracted from the first
mismatched byte in DestinationBuffer. mismatched byte in DestinationBuffer.
If Length > 0 and DestinationBuffer is NULL, then ASSERT(). If Length > 0 and DestinationBuffer is NULL, then ASSERT().
If Length > 0 and SourceBuffer is NULL, then ASSERT(). If Length > 0 and SourceBuffer is NULL, then ASSERT().
If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT(). If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT().
@ -45,7 +45,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
@return 0 All Length bytes of the two buffers are identical. @return 0 All Length bytes of the two buffers are identical.
@retval Non-zero The first mismatched byte in SourceBuffer subtracted from the first @retval Non-zero The first mismatched byte in SourceBuffer subtracted from the first
mismatched byte in DestinationBuffer. mismatched byte in DestinationBuffer.
**/ **/
INTN INTN
EFIAPI EFIAPI

4
MdePkg/Library/BaseMemoryLibRepStr/CompareMemWrapper.c
View File

@ -31,7 +31,7 @@
If all Length bytes of the two buffers are identical, then 0 is returned. Otherwise, the If all Length bytes of the two buffers are identical, then 0 is returned. Otherwise, the
value returned is the first mismatched byte in SourceBuffer subtracted from the first value returned is the first mismatched byte in SourceBuffer subtracted from the first
mismatched byte in DestinationBuffer. mismatched byte in DestinationBuffer.
If Length > 0 and DestinationBuffer is NULL, then ASSERT(). If Length > 0 and DestinationBuffer is NULL, then ASSERT().
If Length > 0 and SourceBuffer is NULL, then ASSERT(). If Length > 0 and SourceBuffer is NULL, then ASSERT().
If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT(). If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT().
@ -44,7 +44,7 @@
@return 0 All Length bytes of the two buffers are identical. @return 0 All Length bytes of the two buffers are identical.
@retval Non-zero The first mismatched byte in SourceBuffer subtracted from the first @retval Non-zero The first mismatched byte in SourceBuffer subtracted from the first
mismatched byte in DestinationBuffer. mismatched byte in DestinationBuffer.
**/ **/
INTN INTN
EFIAPI EFIAPI

4
MdePkg/Library/BaseMemoryLibSse2/CompareMemWrapper.c
View File

@ -31,7 +31,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
If all Length bytes of the two buffers are identical, then 0 is returned. Otherwise, the If all Length bytes of the two buffers are identical, then 0 is returned. Otherwise, the
value returned is the first mismatched byte in SourceBuffer subtracted from the first value returned is the first mismatched byte in SourceBuffer subtracted from the first
mismatched byte in DestinationBuffer. mismatched byte in DestinationBuffer.
If Length > 0 and DestinationBuffer is NULL, then ASSERT(). If Length > 0 and DestinationBuffer is NULL, then ASSERT().
If Length > 0 and SourceBuffer is NULL, then ASSERT(). If Length > 0 and SourceBuffer is NULL, then ASSERT().
If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT(). If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT().
@ -44,7 +44,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
@return 0 All Length bytes of the two buffers are identical. @return 0 All Length bytes of the two buffers are identical.
@retval Non-zero The first mismatched byte in SourceBuffer subtracted from the first @retval Non-zero The first mismatched byte in SourceBuffer subtracted from the first
mismatched byte in DestinationBuffer. mismatched byte in DestinationBuffer.
**/ **/
INTN INTN
EFIAPI EFIAPI

24
MdePkg/Library/BasePalLibNull/PalCall.c
View File

@ -20,14 +20,24 @@
/** /**
Makes a PAL procedure call. Makes a PAL procedure call.
This is a wrapper function to make a PAL procedure call. This is a wrapper function to make a PAL procedure call. Based on the Index value,
This is just a template as simple instance. It does not this API will make static or stacked PAL call. Architected procedures may be designated
make real PAL call. It directly reports error if called. as required or optional. If a PAL procedure is specified as optional, a unique return
code of 0xFFFFFFFFFFFFFFFF is returned in the Status field of the PAL_CALL_RETURN structure.
This indicates that the procedure is not present in this PAL implementation. It is the
caller's responsibility to check for this return code after calling any optional PAL
procedure. No parameter checking is performed on the 4 input parameters, but there are
some common rules that the caller should follow when making a PAL call. Any address
passed to PAL as buffers for return parameters must be 8-byte aligned. Unaligned addresses
may cause undefined results. For those parameters defined as reserved or some fields
defined as reserved must be zero filled or the invalid argument return value may be
returned or undefined result may occur during the execution of the procedure.
This function is only available on IPF.
@param Index The PAL procedure Index number. @param Index The PAL procedure Index number.
@param Arg2 The 2nd parameter for PAL procedure calls. @param Arg2 The 2nd parameter for PAL procedure calls.
@param Arg3 The 3rd parameter for PAL procedure calls. @param Arg3 The 3rd parameter for PAL procedure calls.
@param Arg4 The 4th parameter for PAL procedure calls. @param Arg4 The 4th parameter for PAL procedure calls.
@return Structure returned from the PAL Call procedure, including the status and return value. @return Structure returned from the PAL Call procedure, including the status and return value.

266
MdePkg/Library/BasePcdLibNull/PcdLib.c
View File

@ -20,18 +20,22 @@
/** /**
This function provides a means by which SKU support can be established in the PCD infrastructure.
Sets the current SKU in the PCD database to the value specified by SkuId. SkuId is returned. Sets the current SKU in the PCD database to the value specified by SkuId. SkuId is returned.
@param[in] SkuId The SKU value that will be used when the PCD service will retrieve and @param[in] SkuId The SKU value that will be used when the PCD service will retrieve and
set values associated with a PCD token. set values associated with a PCD token.
If SkuId >= 0x100, then ASSERT().
@return Return the SKU ID that just be set. @return Return the SKU ID that just be set.
**/ **/
UINTN UINTN
EFIAPI EFIAPI
LibPcdSetSku ( LibPcdSetSku (
IN UINTN SkuId IN UINTN SkuId
) )
{ {
ASSERT (FALSE); ASSERT (FALSE);
@ -40,6 +44,8 @@ LibPcdSetSku (
} }
/** /**
This function provides a means by which to retrieve a value for a given PCD token.
Returns the 8-bit value for the token specified by TokenNumber. Returns the 8-bit value for the token specified by TokenNumber.
@param[in] TokenNumber The PCD token number to retrieve a current value for. @param[in] TokenNumber The PCD token number to retrieve a current value for.
@ -61,9 +67,11 @@ LibPcdGet8 (
/** /**
This function provides a means by which to retrieve a value for a given PCD token.
Returns the 16-bit value for the token specified by TokenNumber. Returns the 16-bit value for the token specified by TokenNumber.
@param[in] TokenNumber The PCD token number to retrieve a current value for. @param[in] TokenNumber The PCD token number to retrieve a current value for.
@return Returns the 16-bit value for the token specified by TokenNumber. @return Returns the 16-bit value for the token specified by TokenNumber.
@ -82,6 +90,8 @@ LibPcdGet16 (
/** /**
This function provides a means by which to retrieve a value for a given PCD token.
Returns the 32-bit value for the token specified by TokenNumber. Returns the 32-bit value for the token specified by TokenNumber.
@param[in] TokenNumber The PCD token number to retrieve a current value for. @param[in] TokenNumber The PCD token number to retrieve a current value for.
@ -103,6 +113,8 @@ LibPcdGet32 (
/** /**
This function provides a means by which to retrieve a value for a given PCD token.
Returns the 64-bit value for the token specified by TokenNumber. Returns the 64-bit value for the token specified by TokenNumber.
@param[in] TokenNumber The PCD token number to retrieve a current value for. @param[in] TokenNumber The PCD token number to retrieve a current value for.
@ -124,6 +136,8 @@ LibPcdGet64 (
/** /**
This function provides a means by which to retrieve a value for a given PCD token.
Returns the pointer to the buffer of the token specified by TokenNumber. Returns the pointer to the buffer of the token specified by TokenNumber.
@param[in] TokenNumber The PCD token number to retrieve a current value for. @param[in] TokenNumber The PCD token number to retrieve a current value for.
@ -145,6 +159,8 @@ LibPcdGetPtr (
/** /**
This function provides a means by which to retrieve a value for a given PCD token.
Returns the Boolean value of the token specified by TokenNumber. Returns the Boolean value of the token specified by TokenNumber.
@param[in] TokenNumber The PCD token number to retrieve a current value for. @param[in] TokenNumber The PCD token number to retrieve a current value for.
@ -166,7 +182,7 @@ LibPcdGetBool (
/** /**
Returns the size of the token specified by TokenNumber. This function provides a means by which to retrieve the size of a given PCD token.
@param[in] TokenNumber The PCD token number to retrieve a current value for. @param[in] TokenNumber The PCD token number to retrieve a current value for.
@ -187,7 +203,10 @@ LibPcdGetSize (
/** /**
This function provides a means by which to retrieve a value for a given PCD token.
Returns the 8-bit value for the token specified by TokenNumber and Guid. Returns the 8-bit value for the token specified by TokenNumber and Guid.
If Guid is NULL, then ASSERT(). If Guid is NULL, then ASSERT().
@param[in] Guid Pointer to a 128-bit unique value that designates @param[in] Guid Pointer to a 128-bit unique value that designates
@ -212,7 +231,10 @@ LibPcdGetEx8 (
/** /**
This function provides a means by which to retrieve a value for a given PCD token.
Returns the 16-bit value for the token specified by TokenNumber and Guid. Returns the 16-bit value for the token specified by TokenNumber and Guid.
If Guid is NULL, then ASSERT(). If Guid is NULL, then ASSERT().
@param[in] Guid Pointer to a 128-bit unique value that designates @param[in] Guid Pointer to a 128-bit unique value that designates
@ -262,12 +284,15 @@ LibPcdGetEx32 (
/** /**
This function provides a means by which to retrieve a value for a given PCD token.
Returns the 64-bit value for the token specified by TokenNumber and Guid. Returns the 64-bit value for the token specified by TokenNumber and Guid.
If Guid is NULL, then ASSERT(). If Guid is NULL, then ASSERT().
@param[in] Guid Pointer to a 128-bit unique value that designates @param[in] Guid Pointer to a 128-bit unique value that designates
which namespace to retrieve a value from. which namespace to retrieve a value from.
@param[in] TokenNumber The PCD token number to retrieve a current value for. @param[in] TokenNumber The PCD token number to retrieve a current value for.
@return Return the UINT64. @return Return the UINT64.
@ -287,12 +312,15 @@ LibPcdGetEx64 (
/** /**
Returns the pointer to the buffer of the token specified by TokenNumber and Guid. This function provides a means by which to retrieve a value for a given PCD token.
Returns the pointer to the buffer of token specified by TokenNumber and Guid.
If Guid is NULL, then ASSERT(). If Guid is NULL, then ASSERT().
@param[in] Guid Pointer to a 128-bit unique value that designates @param[in] Guid Pointer to a 128-bit unique value that designates
which namespace to retrieve a value from. which namespace to retrieve a value from.
@param[in] TokenNumber The PCD token number to retrieve a current value for. @param[in] TokenNumber The PCD token number to retrieve a current value for.
@return Return the VOID* pointer. @return Return the VOID* pointer.
@ -312,12 +340,15 @@ LibPcdGetExPtr (
/** /**
This function provides a means by which to retrieve a value for a given PCD token.
Returns the Boolean value of the token specified by TokenNumber and Guid. Returns the Boolean value of the token specified by TokenNumber and Guid.
If Guid is NULL, then ASSERT(). If Guid is NULL, then ASSERT().
@param[in] Guid Pointer to a 128-bit unique value that designates @param[in] Guid Pointer to a 128-bit unique value that designates
which namespace to retrieve a value from. which namespace to retrieve a value from.
@param[in] TokenNumber The PCD token number to retrieve a current value for. @param[in] TokenNumber The PCD token number to retrieve a current value for.
@return Return the BOOLEAN. @return Return the BOOLEAN.
@ -337,12 +368,15 @@ LibPcdGetExBool (
/** /**
This function provides a means by which to retrieve the size of a given PCD token.
Returns the size of the token specified by TokenNumber and Guid. Returns the size of the token specified by TokenNumber and Guid.
If Guid is NULL, then ASSERT(). If Guid is NULL, then ASSERT().
@param[in] Guid Pointer to a 128-bit unique value that designates @param[in] Guid Pointer to a 128-bit unique value that designates
which namespace to retrieve a value from. which namespace to retrieve a value from.
@param[in] TokenNumber The PCD token number to retrieve a current value for. @param[in] TokenNumber The PCD token number to retrieve a current value for.
@return Return the size. @return Return the size.
@ -362,11 +396,13 @@ LibPcdGetExSize (
/** /**
This function provides a means by which to set a value for a given PCD token.
Sets the 8-bit value for the token specified by TokenNumber Sets the 8-bit value for the token specified by TokenNumber
to the value specified by Value. Value is returned. to the value specified by Value. Value is returned.
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 8-bit value to set. @param[in] Value The 8-bit value to set.
@return Return the value been set. @return Return the value been set.
@ -386,11 +422,13 @@ LibPcdSet8 (
/** /**
This function provides a means by which to set a value for a given PCD token.
Sets the 16-bit value for the token specified by TokenNumber Sets the 16-bit value for the token specified by TokenNumber
to the value specified by Value. Value is returned. to the value specified by Value. Value is returned.
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 16-bit value to set. @param[in] Value The 16-bit value to set.
@return Return the value been set. @return Return the value been set.
@ -410,11 +448,13 @@ LibPcdSet16 (
/** /**
This function provides a means by which to set a value for a given PCD token.
Sets the 32-bit value for the token specified by TokenNumber Sets the 32-bit value for the token specified by TokenNumber
to the value specified by Value. Value is returned. to the value specified by Value. Value is returned.
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 32-bit value to set. @param[in] Value The 32-bit value to set.
@return Return the value been set. @return Return the value been set.
@ -422,8 +462,8 @@ LibPcdSet16 (
UINT32 UINT32
EFIAPI EFIAPI
LibPcdSet32 ( LibPcdSet32 (
IN UINTN TokenNumber, IN UINTN TokenNumber,
IN UINT32 Value IN UINT32 Value
) )
{ {
ASSERT (FALSE); ASSERT (FALSE);
@ -434,11 +474,13 @@ LibPcdSet32 (
/** /**
This function provides a means by which to set a value for a given PCD token.
Sets the 64-bit value for the token specified by TokenNumber Sets the 64-bit value for the token specified by TokenNumber
to the value specified by Value. Value is returned. to the value specified by Value. Value is returned.
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 64-bit value to set. @param[in] Value The 64-bit value to set.
@return Return the value been set. @return Return the value been set.
@ -446,8 +488,8 @@ LibPcdSet32 (
UINT64 UINT64
EFIAPI EFIAPI
LibPcdSet64 ( LibPcdSet64 (
IN UINTN TokenNumber, IN UINTN TokenNumber,
IN UINT64 Value IN UINT64 Value
) )
{ {
ASSERT (FALSE); ASSERT (FALSE);
@ -458,22 +500,23 @@ LibPcdSet64 (
/** /**
Sets a buffer for the token specified by TokenNumber to This function provides a means by which to set a value for a given PCD token.
the value specified by Buffer and SizeOfValue. Buffer to
be set is returned. The content of the buffer could be
overwritten if a Callback on SET is registered with this
TokenNumber.
If SizeOfValue is greater than the maximum Sets a buffer for the token specified by TokenNumber to the value
size support by TokenNumber, then set SizeOfValue to the specified by Buffer and SizeOfBuffer. Buffer is returned.
maximum size supported by TokenNumber and return NULL to If SizeOfBuffer is greater than the maximum size support by TokenNumber,
indicate that the set operation was not actually performed. then set SizeOfBuffer to the maximum size supported by TokenNumber and
return NULL to indicate that the set operation was not actually performed.
If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to the
maximum size supported by TokenName and NULL must be returned.
If SizeOfValue > 0 and Buffer is NULL, then ASSERT(). If SizeOfBuffer is NULL, then ASSERT().
If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in, out] SizeOfBuffer The size, in bytes, of Buffer. @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to set. @param[in] Buffer A pointer to the buffer to set.
@return Return the pointer for the buffer been set. @return Return the pointer for the buffer been set.
@ -481,9 +524,9 @@ LibPcdSet64 (
VOID * VOID *
EFIAPI EFIAPI
LibPcdSetPtr ( LibPcdSetPtr (
IN UINTN TokenNumber, IN UINTN TokenNumber,
IN OUT UINTN *SizeOfBuffer, IN OUT UINTN *SizeOfBuffer,
IN CONST VOID *Buffer IN CONST VOID *Buffer
) )
{ {
ASSERT (FALSE); ASSERT (FALSE);
@ -494,11 +537,13 @@ LibPcdSetPtr (
/** /**
This function provides a means by which to set a value for a given PCD token.
Sets the Boolean value for the token specified by TokenNumber Sets the Boolean value for the token specified by TokenNumber
to the value specified by Value. Value is returned. to the value specified by Value. Value is returned.
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The boolean value to set. @param[in] Value The boolean value to set.
@return Return the value been set. @return Return the value been set.
@ -518,14 +563,17 @@ LibPcdSetBool (
/** /**
This function provides a means by which to set a value for a given PCD token.
Sets the 8-bit value for the token specified by TokenNumber and Sets the 8-bit value for the token specified by TokenNumber and
Guid to the value specified by Value. Value is returned. Guid to the value specified by Value. Value is returned.
If Guid is NULL, then ASSERT(). If Guid is NULL, then ASSERT().
@param[in] Guid Pointer to a 128-bit unique value that @param[in] Guid Pointer to a 128-bit unique value that
designates which namespace to set a value from. designates which namespace to set a value from.
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 8-bit value to set. @param[in] Value The 8-bit value to set.
@return Return the value been set. @return Return the value been set.
@ -546,14 +594,17 @@ LibPcdSetEx8 (
/** /**
This function provides a means by which to set a value for a given PCD token.
Sets the 16-bit value for the token specified by TokenNumber and Sets the 16-bit value for the token specified by TokenNumber and
Guid to the value specified by Value. Value is returned. Guid to the value specified by Value. Value is returned.
If Guid is NULL, then ASSERT(). If Guid is NULL, then ASSERT().
@param[in] Guid Pointer to a 128-bit unique value that @param[in] Guid Pointer to a 128-bit unique value that
designates which namespace to set a value from. designates which namespace to set a value from.
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 16-bit value to set. @param[in] Value The 16-bit value to set.
@return Return the value been set. @return Return the value been set.
@ -574,14 +625,17 @@ LibPcdSetEx16 (
/** /**
This function provides a means by which to set a value for a given PCD token.
Sets the 32-bit value for the token specified by TokenNumber and Sets the 32-bit value for the token specified by TokenNumber and
Guid to the value specified by Value. Value is returned. Guid to the value specified by Value. Value is returned.
If Guid is NULL, then ASSERT(). If Guid is NULL, then ASSERT().
@param[in] Guid Pointer to a 128-bit unique value that @param[in] Guid Pointer to a 128-bit unique value that
designates which namespace to set a value from. designates which namespace to set a value from.
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 32-bit value to set. @param[in] Value The 32-bit value to set.
@return Return the value been set. @return Return the value been set.
@ -602,14 +656,16 @@ LibPcdSetEx32 (
/** /**
This function provides a means by which to set a value for a given PCD token.
Sets the 64-bit value for the token specified by TokenNumber and Sets the 64-bit value for the token specified by TokenNumber and
Guid to the value specified by Value. Value is returned. Guid to the value specified by Value. Value is returned.
If Guid is NULL, then ASSERT(). If Guid is NULL, then ASSERT().
@param[in] Guid Pointer to a 128-bit unique value that @param[in] Guid Pointer to a 128-bit unique value that
designates which namespace to set a value from. designates which namespace to set a value from.
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 64-bit value to set. @param[in] Value The 64-bit value to set.
@return Return the value been set. @return Return the value been set.
@ -630,19 +686,23 @@ LibPcdSetEx64 (
/** /**
This function provides a means by which to set a value for a given PCD token.
Sets a buffer for the token specified by TokenNumber to the value specified by Sets a buffer for the token specified by TokenNumber to the value specified by
Buffer and SizeOfValue. Buffer is returned. If SizeOfValue is greater than Buffer and SizeOfBuffer. Buffer is returned. If SizeOfBuffer is greater than
the maximum size support by TokenNumber, then set SizeOfValue to the maximum size the maximum size support by TokenNumber, then set SizeOfBuffer to the maximum size
supported by TokenNumber and return NULL to indicate that the set operation supported by TokenNumber and return NULL to indicate that the set operation
was not actually performed. was not actually performed.
If SizeOfValue > 0 and Buffer is NULL, then ASSERT(). If Guid is NULL, then ASSERT().
If SizeOfBuffer is NULL, then ASSERT().
If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
@param[in] Guid Pointer to a 128-bit unique value that @param[in] Guid Pointer to a 128-bit unique value that
designates which namespace to set a value from. designates which namespace to set a value from.
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in, out] SizeOfBuffer The size, in bytes, of Buffer. @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to set. @param[in] Buffer A pointer to the buffer to set.
@return Return the pinter to the buffer been set. @return Return the pinter to the buffer been set.
@ -664,14 +724,17 @@ LibPcdSetExPtr (
/** /**
This function provides a means by which to set a value for a given PCD token.
Sets the Boolean value for the token specified by TokenNumber and Sets the Boolean value for the token specified by TokenNumber and
Guid to the value specified by Value. Value is returned. Guid to the value specified by Value. Value is returned.
If Guid is NULL, then ASSERT(). If Guid is NULL, then ASSERT().
@param[in] Guid Pointer to a 128-bit unique value that @param[in] Guid Pointer to a 128-bit unique value that
designates which namespace to set a value from. designates which namespace to set a value from.
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The Boolean value to set. @param[in] Value The Boolean value to set.
@return Return the value been set. @return Return the value been set.
@ -692,17 +755,20 @@ LibPcdSetExBool (
/** /**
Set up a notification function that is called when a specified token is set.
When the token specified by TokenNumber and Guid is set, When the token specified by TokenNumber and Guid is set,
then notification function specified by NotificationFunction is called. then notification function specified by NotificationFunction is called.
If Guid is NULL, then the default token space is used. If Guid is NULL, then the default token space is used.
If NotificationFunction is NULL, then ASSERT(). If NotificationFunction is NULL, then ASSERT().
@param[in] Guid Pointer to a 128-bit unique value that designates which @param[in] Guid Pointer to a 128-bit unique value that designates which
namespace to set a value from. If NULL, then the default namespace to set a value from. If NULL, then the default
token space is used. token space is used.
@param[in] TokenNumber The PCD token number to monitor. @param[in] TokenNumber The PCD token number to monitor.
@param[in] NotificationFunction The function to call when the token @param[in] NotificationFunction The function to call when the token
specified by Guid and TokenNumber is set. specified by Guid and TokenNumber is set.
**/ **/
VOID VOID
@ -720,10 +786,15 @@ LibPcdCallbackOnSet (
/** /**
Disable a notification function that was established with LibPcdCallbackonSet(). Disable a notification function that was established with LibPcdCallbackonSet().
Disable a notification function that was previously established with LibPcdCallbackOnSet().
If NotificationFunction is NULL, then ASSERT(). If NotificationFunction is NULL, then ASSERT().
If LibPcdCallbackOnSet() was not previously called with Guid, TokenNumber,
@param[in] Guid Specify the GUID token space. and NotificationFunction, then ASSERT().
@param[in] TokenNumber Specify the token number.
@param[in] Guid Specify the GUID token space.
@param[in] TokenNumber Specify the token number.
@param[in] NotificationFunction The callback function to be unregistered. @param[in] NotificationFunction The callback function to be unregistered.
**/ **/
@ -741,17 +812,20 @@ LibPcdCancelCallback (
/** /**
Retrieves the next token in a token space.
Retrieves the next PCD token number from the token space specified by Guid. Retrieves the next PCD token number from the token space specified by Guid.
If Guid is NULL, then the default token space is used. If TokenNumber is 0, If Guid is NULL, then the default token space is used. If TokenNumber is 0,
then the first token number is returned. Otherwise, the token number that then the first token number is returned. Otherwise, the token number that
follows TokenNumber in the token space is returned. If TokenNumber is the last follows TokenNumber in the token space is returned. If TokenNumber is the last
token number in the token space, then 0 is returned. If TokenNumber is not 0 and token number in the token space, then 0 is returned.
is not in the token space specified by Guid, then ASSERT().
If TokenNumber is not 0 and is not in the token space specified by Guid, then ASSERT().
@param[in] Guid Pointer to a 128-bit unique value that designates which namespace @param[in] Guid Pointer to a 128-bit unique value that designates which namespace
to set a value from. If NULL, then the default token space is used. to set a value from. If NULL, then the default token space is used.
@param[in] TokenNumber The previous PCD token number. If 0, then retrieves the first PCD @param[in] TokenNumber The previous PCD token number. If 0, then retrieves the first PCD
token number. token number.
@return The next valid token number. @return The next valid token number.
@ -759,8 +833,8 @@ LibPcdCancelCallback (
UINTN UINTN
EFIAPI EFIAPI
LibPcdGetNextToken ( LibPcdGetNextToken (
IN CONST GUID *Guid, OPTIONAL IN CONST GUID *Guid, OPTIONAL
IN UINTN TokenNumber IN UINTN TokenNumber
) )
{ {
ASSERT (FALSE); ASSERT (FALSE);
@ -771,6 +845,8 @@ LibPcdGetNextToken (
/** /**
Used to retrieve the list of available PCD token space GUIDs.
Retrieves the next PCD token space from a token space specified by Guid. Retrieves the next PCD token space from a token space specified by Guid.
Guid of NULL is reserved to mark the default local token namespace on the current Guid of NULL is reserved to mark the default local token namespace on the current
platform. If Guid is NULL, then the GUID of the first non-local token space of the platform. If Guid is NULL, then the GUID of the first non-local token space of the
@ -778,6 +854,8 @@ LibPcdGetNextToken (
then NULL is returned. then NULL is returned.
If Guid is not NULL and is not a valid token space in the current platform, then ASSERT(). If Guid is not NULL and is not a valid token space in the current platform, then ASSERT().
@param[in] Guid Pointer to a 128-bit unique value that designates from which namespace @param[in] Guid Pointer to a 128-bit unique value that designates from which namespace
to start the search. to start the search.
@ -788,7 +866,7 @@ LibPcdGetNextToken (
GUID * GUID *
EFIAPI EFIAPI
LibPcdGetNextTokenSpace ( LibPcdGetNextTokenSpace (
IN CONST GUID *Guid IN CONST GUID *TokenSpaceGuid
) )
{ {
ASSERT (FALSE); ASSERT (FALSE);

2
MdePkg/Library/BasePciLibCf8/PciLib.c
View File

@ -1108,7 +1108,7 @@ PciReadBuffer (
@param Size Size in bytes of the transfer. @param Size Size in bytes of the transfer.
@param Buffer Pointer to a buffer containing the data to write. @param Buffer Pointer to a buffer containing the data to write.
@return Size @return Size written to StartAddress.
**/ **/
UINTN UINTN

2
MdePkg/Library/BasePciLibPciExpress/PciLib.c
View File

@ -1108,7 +1108,7 @@ PciReadBuffer (
@param Size Size in bytes of the transfer. @param Size Size in bytes of the transfer.
@param Buffer Pointer to a buffer containing the data to write. @param Buffer Pointer to a buffer containing the data to write.
@return Size @return Size written to StartAddress.
**/ **/
UINTN UINTN

37
MdePkg/Library/BasePeCoffLib/BasePeCoff.c
View File

@ -195,7 +195,7 @@ PeCoffLoaderGetPeHeader (
RETURN_STATUS RETURN_STATUS
EFIAPI EFIAPI
PeCoffLoaderGetImageInfo ( PeCoffLoaderGetImageInfo (
IN OUT PE_COFF_LOADER_IMAGE_CONTEXT *ImageContext IN OUT PE_COFF_LOADER_IMAGE_CONTEXT *ImageContext
) )
{ {
RETURN_STATUS Status; RETURN_STATUS Status;
@ -487,6 +487,12 @@ PeCoffLoaderImageAddress (
ImageContext as the relocation base address. Otherwise, use the DestinationAddress field ImageContext as the relocation base address. Otherwise, use the DestinationAddress field
of ImageContext as the relocation base address. The caller must allocate the relocation of ImageContext as the relocation base address. The caller must allocate the relocation
fixup log buffer and fill in the FixupData field of ImageContext prior to calling this function. fixup log buffer and fill in the FixupData field of ImageContext prior to calling this function.
The ImageRead, Handle, PeCoffHeaderOffset, IsTeImage, Machine, ImageType, ImageAddress,
ImageSize, DestinationAddress, RelocationsStripped, SectionAlignment, SizeOfHeaders,
DebugDirectoryEntryRva, EntryPoint, FixupDataSize, CodeView, PdbPointer, and FixupData of
the ImageContext structure must be valid prior to invoking this service.
If ImageContext is NULL, then ASSERT(). If ImageContext is NULL, then ASSERT().
@param ImageContext Pointer to the image context structure that describes the PE/COFF @param ImageContext Pointer to the image context structure that describes the PE/COFF
@ -725,6 +731,10 @@ PeCoffLoaderRelocateImage (
specified by the ImageAddress and ImageSize fields of ImageContext. The caller must allocate specified by the ImageAddress and ImageSize fields of ImageContext. The caller must allocate
the load buffer and fill in the ImageAddress and ImageSize fields prior to calling this function. the load buffer and fill in the ImageAddress and ImageSize fields prior to calling this function.
The EntryPoint, FixupDataSize, CodeView, and PdbPointer fields of ImageContext are computed. The EntryPoint, FixupDataSize, CodeView, and PdbPointer fields of ImageContext are computed.
The ImageRead, Handle, PeCoffHeaderOffset, IsTeImage, Machine, ImageType, ImageAddress, ImageSize,
DestinationAddress, RelocationsStripped, SectionAlignment, SizeOfHeaders, and DebugDirectoryEntryRva
fields of the ImageContext structure must be valid prior to invoking this service.
If ImageContext is NULL, then ASSERT(). If ImageContext is NULL, then ASSERT().
@param ImageContext Pointer to the image context structure that describes the PE/COFF @param ImageContext Pointer to the image context structure that describes the PE/COFF
@ -1117,17 +1127,20 @@ PeCoffLoaderLoadImage (
/** /**
Reapply fixups on a fixed up PE32/PE32+ image to allow virutal calling at EFI Reapply fixups on a fixed up PE32/PE32+ image to allow virutal calling at EFI
runtime. runtime.
PE_COFF_LOADER_IMAGE_CONTEXT.FixupData stores information needed to reapply PE_COFF_LOADER_IMAGE_CONTEXT.FixupData stores information needed to reapply
the fixups with a virtual mapping. the fixups with a virtual mapping.
@param ImageBase Base address of relocated image @param ImageBase Base address of a PE/COFF image that has been loaded
@param VirtImageBase Virtual mapping for ImageBase and relocated into system memory.
@param ImageSize Size of the image to relocate @param VirtImageBase The request virtual address that the PE/COFF image is to
@param RelocationData Location to place results of read be fixed up for.
@param ImageSize The size, in bytes, of the PE/COFF image.
@param RelocationData A pointer to the relocation data that was collected when the PE/COFF
image was relocated using PeCoffLoaderRelocateImage().
**/ **/
VOID VOID
EFIAPI EFIAPI
@ -1360,11 +1373,15 @@ PeCoffLoaderImageReadFromMemory (
/** /**
Unloads a loaded PE/COFF image from memory and releases its taken resource. Unloads a loaded PE/COFF image from memory and releases its taken resource.
Releases any environment specific resources that were allocated when the image
specified by ImageContext was loaded using PeCoffLoaderLoadImage().
For NT32 emulator, the PE/COFF image loaded by system needs to release. For NT32 emulator, the PE/COFF image loaded by system needs to release.
For real platform, the PE/COFF image loaded by Core doesn't needs to be unloaded, For real platform, the PE/COFF image loaded by Core doesn't needs to be unloaded,
this function can simply return RETURN_SUCCESS. this function can simply return RETURN_SUCCESS.
If ImageContext is NULL, then ASSERT().
@param ImageContext Pointer to the image context structure that describes the PE/COFF @param ImageContext Pointer to the image context structure that describes the PE/COFF
image to be unloaded. image to be unloaded.

15
MdePkg/Library/BasePeCoffLib/PeCoffLoaderEx.c
View File

@ -16,14 +16,15 @@
/** /**
Performs an IA-32 specific relocation fixup. Performs an Itanium-based specific relocation fixup and is a no-op on other
instruction sets.
@param Reloc Pointer to the relocation record. @param Reloc Pointer to the relocation record.
@param Fixup Pointer to the address to fix up. @param Fixup Pointer to the address to fix up.
@param FixupData Pointer to a buffer to log the fixups. @param FixupData Pointer to a buffer to log the fixups.
@param Adjust The offset to adjust the fixup. @param Adjust The offset to adjust the fixup.
@retval EFI_UNSUPPORTED Unsupported now. @return Status code.
**/ **/
RETURN_STATUS RETURN_STATUS
@ -38,14 +39,10 @@ PeCoffLoaderRelocateImageEx (
} }
/** /**
Returns TRUE if the machine type of PE/COFF image is supported. Supported Returns TRUE if the machine type of PE/COFF image is supported. Supported
does not mean the image can be executed it means the PE/COFF loader supports does not mean the image can be executed it means the PE/COFF loader supports
loading and relocating of the image type. It's up to the caller to support loading and relocating of the image type. It's up to the caller to support
the entry point. the entry point.
This function implies the basic PE/COFF loader/relocator supports IA32, EBC,
& x64 images. Calling the entry point in a correct mannor is up to the
consumer of this library.
@param Machine Machine type from the PE Header. @param Machine Machine type from the PE Header.
@ -75,7 +72,7 @@ PeCoffLoaderImageFormatSupported (
@param FixupData Pointer to a buffer to log the fixups. @param FixupData Pointer to a buffer to log the fixups.
@param Adjust The offset to adjust the fixup. @param Adjust The offset to adjust the fixup.
@return Always return UNSUPPORTED. @return Status code.
**/ **/
RETURN_STATUS RETURN_STATUS

6
MdePkg/Library/BasePerformanceLibNull/PerformanceLib.c
View File

@ -44,9 +44,9 @@
RETURN_STATUS RETURN_STATUS
EFIAPI EFIAPI
StartPerformanceMeasurement ( StartPerformanceMeasurement (
IN CONST VOID *Handle, OPTIONAL IN CONST VOID *Handle, OPTIONAL
IN CONST CHAR8 *Token, OPTIONAL IN CONST CHAR8 *Token, OPTIONAL
IN CONST CHAR8 *Module, OPTIONAL IN CONST CHAR8 *Module, OPTIONAL
IN UINT64 TimeStamp IN UINT64 TimeStamp
) )
{ {

2
MdePkg/Library/BasePostCodeLibPort80/PostCode.c
View File

@ -66,7 +66,7 @@ PostCode (
@param Value The 32-bit value to write to the POST card. @param Value The 32-bit value to write to the POST card.
@param Description Pointer to an ASCII string that is a description of the @param Description Pointer to an ASCII string that is a description of the
POST code value. This is an optional parameter that may POST code value. This is an optional parameter that may
be NULL. Ihis parameter is ignored in this implementation. be NULL.
@return The 32-bit value to write to the POST card. @return The 32-bit value to write to the POST card.

2
MdePkg/Library/BasePrintLib/PrintLib.c
View File

@ -334,7 +334,7 @@ AsciiVSPrint (
@param FormatString Null-terminated ASCII format string. @param FormatString Null-terminated ASCII format string.
@param ... Variable argument list whose contents are accessed based on the @param ... Variable argument list whose contents are accessed based on the
format string specified by FormatString. format string specified by FormatString.
@return The number of ASCII characters in the produced output buffer not including the @return The number of ASCII characters in the produced output buffer not including the
Null-terminator. Null-terminator.

16
MdePkg/Library/BasePrintLib/PrintLibInternal.c
View File

@ -100,8 +100,8 @@ BasePrintLibFillBuffer (
**/ **/
UINTN UINTN
BasePrintLibValueToString ( BasePrintLibValueToString (
IN OUT CHAR8 *Buffer, IN OUT CHAR8 *Buffer,
IN INT64 Value, IN INT64 Value,
IN UINTN Radix IN UINTN Radix
) )
{ {
@ -131,7 +131,7 @@ BasePrintLibValueToString (
Converts the decimal number specified by Value to a Null-terminated Converts the decimal number specified by Value to a Null-terminated
string specified by Buffer containing at most Width characters. string specified by Buffer containing at most Width characters.
If Width is 0 then a width of MAXIMUM_VALUE_CHARACTERS is assumed. If Width is 0 then a width of MAXIMUM_VALUE_CHARACTERS is assumed.
The number of characters in Buffer is returned not including the Null-terminator. The total number of characters placed in Buffer is returned.
If the conversion contains more than Width characters, then only the first If the conversion contains more than Width characters, then only the first
Width characters are returned, and the total number of characters Width characters are returned, and the total number of characters
required to perform the conversion is returned. required to perform the conversion is returned.
@ -141,13 +141,11 @@ BasePrintLibValueToString (
If Width is 0, PREFIX_ZERO is ignored in Flags. If Width is 0, PREFIX_ZERO is ignored in Flags.
If COMMA_TYPE is set in Flags, then PREFIX_ZERO is ignored in Flags, and commas If COMMA_TYPE is set in Flags, then PREFIX_ZERO is ignored in Flags, and commas
are inserted every 3rd digit starting from the right. are inserted every 3rd digit starting from the right.
If HEX_RADIX is set in Flags, then the output buffer will be formatted in hexadecimal format. If Value is < 0, then the fist character in Buffer is a '-'.
If Value is < 0 and HEX_RADIX is not set in Flags, then the fist character in Buffer is a '-'.
If PREFIX_ZERO is set in Flags and PREFIX_ZERO is not being ignored, If PREFIX_ZERO is set in Flags and PREFIX_ZERO is not being ignored,
then Buffer is padded with '0' characters so the combination of the optional '-' then Buffer is padded with '0' characters so the combination of the optional '-'
sign character, '0' characters, digit characters for Value, and the Null-terminator sign character, '0' characters, digit characters for Value, and the Null-terminator
add up to Width characters. add up to Width characters.
If both COMMA_TYPE and HEX_RADIX are set in Flags, then ASSERT().
If Buffer is NULL, then ASSERT(). If Buffer is NULL, then ASSERT().
If unsupported bits are set in Flags, then ASSERT(). If unsupported bits are set in Flags, then ASSERT().
@ -162,7 +160,7 @@ BasePrintLibValueToString (
the Null-terminator. the Null-terminator.
@param Increment Character increment in Buffer. @param Increment Character increment in Buffer.
@return The number of characters in Buffer not including the Null-terminator. @return Total number of characters required to perform the conversion.
**/ **/
UINTN UINTN
@ -792,7 +790,7 @@ BasePrintLibVSPrint (
VSPrint function to process format and place the results in Buffer. Since a VSPrint function to process format and place the results in Buffer. Since a
VA_LIST is used this rountine allows the nesting of Vararg routines. Thus VA_LIST is used this rountine allows the nesting of Vararg routines. Thus
this is the main print working routine. this is the main print working routine
@param StartOfBuffer Character buffer to print the results of the parsing @param StartOfBuffer Character buffer to print the results of the parsing
of Format into. of Format into.
@ -803,7 +801,7 @@ BasePrintLibVSPrint (
@param FormatString Null-terminated format string. @param FormatString Null-terminated format string.
@param ... The variable argument list. @param ... The variable argument list.
@return Number of characters printed not including the Null-terminator. @return Number of characters printed.
**/ **/
UINTN UINTN

16
MdePkg/Library/BaseUefiDecompressLib/BaseUefiDecompressLib.c
View File

@ -81,8 +81,8 @@ FillBuf (
/** /**
Get NumOfBits of bits out from mBitBuf. Get NumOfBits of bits out from mBitBuf.
Get NumOfBits of bits out from mBitBuf. Fill mBitBuf with subsequent Get NumOfBits of bits out from mBitBuf. Fill mBitBuf with subsequent
NumOfBits of bits from source. Returns NumOfBits of bits that are NumOfBits of bits from source. Returns NumOfBits of bits that are
popped out. popped out.
@param Sd The global scratch data. @param Sd The global scratch data.
@ -115,14 +115,14 @@ GetBits (
/** /**
Creates Huffman Code mapping table according to code length array. Creates Huffman Code mapping table according to code length array.
Creates Huffman Code mapping table for Extra Set, Char&Len Set Creates Huffman Code mapping table for Extra Set, Char&Len Set
and Position Set according to code length array. and Position Set according to code length array.
@param Sd The global scratch data @param Sd The global scratch data
@param NumOfChar Number of symbols in the symbol set @param NumOfChar Number of symbols in the symbol set
@param BitLen Code length array @param BitLen Code length array
@param TableBits The width of the mapping table @param TableBits The width of the mapping table
@param Table The table to be created @param Table The table to be created.
@retval 0 OK. @retval 0 OK.
@retval BAD_TABLE The table is corrupted. @retval BAD_TABLE The table is corrupted.
@ -251,7 +251,7 @@ MakeTable (
Decodes a position value. Decodes a position value.
Get a position value according to Position Huffman Table. Get a position value according to Position Huffman Table.
@param Sd the global scratch data @param Sd the global scratch data
@return The position value decoded. @return The position value decoded.
@ -391,7 +391,7 @@ ReadPTLen (
/** /**
Reads code lengths for Char&Len Set. Reads code lengths for Char&Len Set.
Read in and decode the Char&Len Set Code Length Array, then Read in and decode the Char&Len Set Code Length Array, then
generate the Huffman Code mapping table for the Char&Len Set. generate the Huffman Code mapping table for the Char&Len Set.
@ -482,7 +482,7 @@ ReadCLen (
/** /**
Decode a character/length value. Decode a character/length value.
Read one value from mBitBuf, Get one code from mBitBuf. If it is at block boundary, generates Read one value from mBitBuf, Get one code from mBitBuf. If it is at block boundary, generates
Huffman code mapping table for Extra Set, Code&Len Set and Huffman code mapping table for Extra Set, Code&Len Set and
Position Set. Position Set.
@ -561,7 +561,7 @@ DecodeC (
/** /**
Decode the source data and put the resulting data into the destination buffer. Decode the source data and put the resulting data into the destination buffer.
@param Sd The global scratch data @param Sd The global scratch data
**/ **/