From: qhuang8 Date: Wed, 27 Jan 2010 03:25:28 +0000 (+0000) Subject: Clean up MdePkg source to correct some coding style issues, etc. X-Git-Tag: edk2-stable201903~16504 X-Git-Url: https://git.proxmox.com/?p=mirror_edk2.git;a=commitdiff_plain;h=ea6898b902464c0a0c32b49543386b962a64032c Clean up MdePkg source to correct some coding style issues, etc. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@9832 6f19259b-4bc3-4df7-8a09-765794883524 --- diff --git a/MdePkg/Include/Arm/ProcessorBind.h b/MdePkg/Include/Arm/ProcessorBind.h index 6b75325f87..5ec371b55b 100644 --- a/MdePkg/Include/Arm/ProcessorBind.h +++ b/MdePkg/Include/Arm/ProcessorBind.h @@ -1,8 +1,7 @@ - /** @file Processor or Compiler specific defines and types for ARM. - Copyright (c) 2006 - 2009, Intel Corporation
+ Copyright (c) 2006 - 2010, Intel Corporation
Portions copyright (c) 2008-2009 Apple Inc. All rights reserved.
All rights reserved. This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License diff --git a/MdePkg/Include/Library/DxeServicesLib.h b/MdePkg/Include/Library/DxeServicesLib.h index 944535d4a0..abfdde6d62 100644 --- a/MdePkg/Include/Library/DxeServicesLib.h +++ b/MdePkg/Include/Library/DxeServicesLib.h @@ -2,7 +2,7 @@ MDE DXE Services Library provides functions that simplify the development of DXE Drivers. These functions help access data from sections of FFS files or from file path. - Copyright (c) 2008 - 2009, Intel Corporation
+ Copyright (c) 2008 - 2010, Intel Corporation
All rights reserved. This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License which accompanies this distribution. The full text of the license may be found at @@ -167,16 +167,15 @@ GetSectionFromFfs ( If FileSize is NULL, then NULL is returned. If AuthenticationStatus is NULL, then NULL is returned. - @param[in] BootPolicy - Policy for Open Image File.If TRUE, indicates that the request - originates from the boot manager, and that the boot manager is - attempting to load FilePath as a boot selection. If FALSE, - then FilePath must match an exact file to be loaded. - @param[in] File Pointer to the device path of the file that is absracted to the file buffer. - @param[out] FileSize Pointer to the size of the abstracted file buffer. - @param[out] AuthenticationStatus - Pointer to a caller-allocated UINT32 in which - the authentication status is returned. + @param[in] BootPolicy Policy for Open Image File.If TRUE, indicates that the request + originates from the boot manager, and that the boot manager is + attempting to load FilePath as a boot selection. If FALSE, + then FilePath must match an exact file to be loaded. + @param[in] FilePath Pointer to the device path of the file that is absracted to + the file buffer. + @param[out] FileSize Pointer to the size of the abstracted file buffer. + @param[out] AuthenticationStatus Pointer to a caller-allocated UINT32 in which the authentication + status is returned. @retval NULL File is NULL, or FileSize is NULL. Or the file can't be found. @retval other The abstracted file buffer. The caller is responsible to free memory. diff --git a/MdePkg/Include/Protocol/AtaPassThru.h b/MdePkg/Include/Protocol/AtaPassThru.h index 86d56418e9..40e31d46a7 100644 --- a/MdePkg/Include/Protocol/AtaPassThru.h +++ b/MdePkg/Include/Protocol/AtaPassThru.h @@ -3,7 +3,7 @@ to send ATA Command Blocks to any ATA device attached to that ATA controller. The information includes the attributes of the ATA controller. - Copyright (c) 2009, Intel Corporation + Copyright (c) 2009 - 2010, Intel Corporation All rights reserved. This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License which accompanies this distribution. The full text of the license may be found at @@ -74,10 +74,10 @@ typedef struct _EFI_ATA_STATUS_BLOCK { UINT8 AtaSectorNumberExp; UINT8 AtaCylinderLowExp; UINT8 AtaCylinderHighExp; - UINT8 Reserved; + UINT8 Reserved2; UINT8 AtaSectorCount; UINT8 AtaSectorCountExp; - UINT8 Reserved2[6]; + UINT8 Reserved3[6]; } EFI_ATA_STATUS_BLOCK; typedef UINT8 EFI_ATA_PASS_THRU_CMD_PROTOCOL; diff --git a/MdePkg/Include/Protocol/Eap.h b/MdePkg/Include/Protocol/Eap.h index cf775d5274..d301f6d69a 100644 --- a/MdePkg/Include/Protocol/Eap.h +++ b/MdePkg/Include/Protocol/Eap.h @@ -5,7 +5,7 @@ The definitions in this file are defined in UEFI Specification 2.3, which have not been verified by one implementation yet. - Copyright (c) 2009, Intel Corporation + Copyright (c) 2009 - 2010, Intel Corporation All rights reserved. This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License which accompanies this distribution. The full text of the license may be found at @@ -101,7 +101,7 @@ EFI_STATUS typedef EFI_STATUS (EFIAPI *EFI_EAP_SET_DESIRED_AUTHENTICATION_METHOD)( - IN struct _EFI_EAP_PROTOCOL *This, + IN EFI_EAP_PROTOCOL *This, IN UINT8 EapAuthType ); @@ -131,7 +131,7 @@ EFI_STATUS typedef EFI_STATUS (EFIAPI *EFI_EAP_REGISTER_AUTHENTICATION_METHOD)( - IN struct _EFI_EAP_PROTOCOL *This, + IN EFI_EAP_PROTOCOL *This, IN UINT8 EapAuthType, IN EFI_EAP_BUILD_RESPONSE_PACKET Handler ); diff --git a/MdePkg/Include/Protocol/EapManagement.h b/MdePkg/Include/Protocol/EapManagement.h index 877b802c46..fae4a6a643 100644 --- a/MdePkg/Include/Protocol/EapManagement.h +++ b/MdePkg/Include/Protocol/EapManagement.h @@ -6,7 +6,7 @@ The definitions in this file are defined in UEFI Specification 2.2, which have not been verified by one implementation yet. - Copyright (c) 2009, Intel Corporation + Copyright (c) 2009 - 2010, Intel Corporation All rights reserved. This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License which accompanies this distribution. The full text of the license may be found at @@ -202,7 +202,7 @@ typedef struct _EFI_EAPOL_SUPPLICANT_PAE_STATISTICS { typedef EFI_STATUS (EFIAPI *EFI_EAP_GET_SYSTEM_CONFIGURATION)( - IN struct _EFI_EAP_MANAGEMENT_PROTOCOL *This, + IN EFI_EAP_MANAGEMENT_PROTOCOL *This, OUT BOOLEAN *SystemAuthControl, OUT EFI_EAPOL_PORT_INFO *PortInfo OPTIONAL ); @@ -226,7 +226,7 @@ EFI_STATUS typedef EFI_STATUS (EFIAPI *EFI_EAP_SET_SYSTEM_CONFIGURATION)( - IN struct _EFI_EAP_MANAGEMENT_PROTOCOL *This, + IN EFI_EAP_MANAGEMENT_PROTOCOL *This, IN BOOLEAN SystemAuthControl ); @@ -244,7 +244,7 @@ EFI_STATUS typedef EFI_STATUS (EFIAPI *EFI_EAP_INITIALIZE_PORT)( - IN struct _EFI_EAP_MANAGEMENT_PROTOCOL *This + IN EFI_EAP_MANAGEMENT_PROTOCOL *This ); /** @@ -262,7 +262,7 @@ EFI_STATUS typedef EFI_STATUS (EFIAPI *EFI_EAP_USER_LOGON)( - IN struct _EFI_EAP_MANAGEMENT_PROTOCOL *This + IN EFI_EAP_MANAGEMENT_PROTOCOL *This ); /** @@ -280,7 +280,7 @@ EFI_STATUS typedef EFI_STATUS (EFIAPI *EFI_EAP_USER_LOGOFF)( - IN struct _EFI_EAP_MANAGEMENT_PROTOCOL *This + IN EFI_EAP_MANAGEMENT_PROTOCOL *This ); /** @@ -318,7 +318,7 @@ EFI_STATUS typedef EFI_STATUS (EFIAPI *EFI_EAP_GET_SUPPLICANT_STATUS)( - IN struct _EFI_EAP_MANAGEMENT_PROTOCOL *This, + IN EFI_EAP_MANAGEMENT_PROTOCOL *This, OUT EFI_EAPOL_SUPPLICANT_PAE_STATE *CurrentState, IN OUT EFI_EAPOL_SUPPLICANT_PAE_CONFIGURATION *Configuration OPTIONAL ); @@ -349,7 +349,7 @@ EFI_STATUS typedef EFI_STATUS (EFIAPI *EFI_EAP_SET_SUPPLICANT_CONFIGURATION)( - IN struct _EFI_EAP_MANAGEMENT_PROTOCOL *This, + IN EFI_EAP_MANAGEMENT_PROTOCOL *This, IN EFI_EAPOL_SUPPLICANT_PAE_CONFIGURATION *Configuration ); @@ -375,7 +375,7 @@ EFI_STATUS typedef EFI_STATUS (EFIAPI *EFI_EAP_GET_SUPPLICANT_STATISTICS)( - IN struct _EFI_EAP_MANAGEMENT_PROTOCOL *This, + IN EFI_EAP_MANAGEMENT_PROTOCOL *This, OUT EFI_EAPOL_SUPPLICANT_PAE_STATISTICS *Statistics ); diff --git a/MdePkg/Include/Protocol/Ip6.h b/MdePkg/Include/Protocol/Ip6.h index 590c981801..7fe7eeeb61 100644 --- a/MdePkg/Include/Protocol/Ip6.h +++ b/MdePkg/Include/Protocol/Ip6.h @@ -10,7 +10,7 @@ Listener Discovery Protocol (MLD), and a subset of the Internet Control Message Protocol (ICMPv6). - Copyright (c) 2008 - 2009, Intel Corporation + Copyright (c) 2008 - 2010, Intel Corporation All rights reserved. This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License which accompanies this distribution. The full text of the license may be found at @@ -838,7 +838,7 @@ EFI_STATUS is signaled. @param[in] This Pointer to the EFI_IP6_PROTOCOL instance. - @param]in] Token Pointer to a token that is associated with the receive data descriptor. + @param[in] Token Pointer to a token that is associated with the receive data descriptor. @retval EFI_SUCCESS The receive completion token was cached. @retval EFI_NOT_STARTED This EFI IPv6 Protocol instance has not been started. diff --git a/MdePkg/Include/Protocol/Ip6Config.h b/MdePkg/Include/Protocol/Ip6Config.h index 3d7370843a..ad9d0bad1b 100644 --- a/MdePkg/Include/Protocol/Ip6Config.h +++ b/MdePkg/Include/Protocol/Ip6Config.h @@ -2,7 +2,7 @@ This file provides a definition of the EFI IPv6 Configuration Protocol. -Copyright (c) 2008 - 2009, Intel Corporation.
+Copyright (c) 2008 - 2010, Intel Corporation.
All rights reserved. This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License which accompanies this distribution. The full text of the license may be found at
@@ -231,7 +231,7 @@ typedef struct { - Data is NULL. - One or more fields in Data do not match the requirement of the data type indicated by DataType. - @rerval EFI_WRITE_PROTECTED The specified configuration data is read-only or the specified + @retval EFI_WRITE_PROTECTED The specified configuration data is read-only or the specified configuration data can not be set under the current policy @retval EFI_ACCESS_DENIED Another set operation on the specified configuration data is already in process. @@ -283,7 +283,7 @@ EFI_STATUS - This is NULL. - DataSize is NULL. - Data is NULL if *DataSize is not zero. - @rerval EFI_BUFFER_TOO_SMALL The size of Data is too small for the specified configuration data + @retval EFI_BUFFER_TOO_SMALL The size of Data is too small for the specified configuration data and the required size is returned in DataSize. @retval EFI_NOT_READY The specified configuration data is not ready due to an already in progress asynchronous configuration process. @@ -315,7 +315,7 @@ EFI_STATUS @retval EFI_SUCCESS The notification event for the specified configuration data is registered. @retval EFI_INVALID_PARAMETER This is NULL or Event is NULL. - @rerval EFI_UNSUPPORTED The configuration data type specified by DataType is not + @retval EFI_UNSUPPORTED The configuration data type specified by DataType is not supported. @retval EFI_OUT_OF_RESOURCES Required system resources could not be allocated. @retval EFI_ACCESS_DENIED The Event is already registered for the DataType. @@ -340,7 +340,7 @@ EFI_STATUS @retval EFI_SUCCESS The event registered for the specified configuration data is removed. @retval EFI_INVALID_PARAMETER This is NULL or Event is NULL. - @rerval EFI_NOT_FOUND The Event has not been registered for the specified + @retval EFI_NOT_FOUND The Event has not been registered for the specified DataType. **/ diff --git a/MdePkg/Include/Protocol/S3SaveState.h b/MdePkg/Include/Protocol/S3SaveState.h index 2d5c566420..ec2067226c 100644 --- a/MdePkg/Include/Protocol/S3SaveState.h +++ b/MdePkg/Include/Protocol/S3SaveState.h @@ -5,7 +5,7 @@ to be replayed during an S3 resume. This protocol is not required for all platforms. - Copyright (c) 2009, Intel Corporation + Copyright (c) 2009 - 2010, Intel Corporation All rights reserved. This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License which accompanies this distribution. The full text of the license may be found at @@ -51,8 +51,8 @@ typedef struct _EFI_S3_SAVE_STATE_PROTOCOL EFI_S3_SAVE_STATE_PROTOCOL; typedef EFI_STATUS (EFIAPI *EFI_S3_SAVE_STATE_WRITE)( - IN CONST struct _EFI_S3_SAVE_STATE_PROTOCOL *This, - IN UINT16 OpCode, + IN CONST EFI_S3_SAVE_STATE_PROTOCOL *This, + IN UINT16 OpCode, ... ); @@ -95,10 +95,10 @@ EFI_STATUS typedef EFI_STATUS (EFIAPI *EFI_S3_SAVE_STATE_INSERT)( - IN CONST struct _EFI_S3_SAVE_STATE_PROTOCOL *This, - IN BOOLEAN BeforeOrAfter, - IN OUT EFI_S3_BOOT_SCRIPT_POSITION *Position OPTIONAL, - IN UINT16 OpCode, + IN CONST EFI_S3_SAVE_STATE_PROTOCOL *This, + IN BOOLEAN BeforeOrAfter, + IN OUT EFI_S3_BOOT_SCRIPT_POSITION *Position OPTIONAL, + IN UINT16 OpCode, ... ); @@ -132,10 +132,10 @@ EFI_STATUS typedef EFI_STATUS (EFIAPI *EFI_S3_SAVE_STATE_LABEL)( - IN CONST struct _EFI_S3_SAVE_STATE_PROTOCOL *This, - IN BOOLEAN BeforeOrAfter, - IN BOOLEAN CreateIfNotFound, - IN OUT EFI_S3_BOOT_SCRIPT_POSITION *Position OPTIONAL, + IN CONST EFI_S3_SAVE_STATE_PROTOCOL *This, + IN BOOLEAN BeforeOrAfter, + IN BOOLEAN CreateIfNotFound, + IN OUT EFI_S3_BOOT_SCRIPT_POSITION *Position OPTIONAL, IN CONST CHAR8 *Label ); @@ -157,7 +157,7 @@ EFI_STATUS typedef EFI_STATUS (EFIAPI *EFI_S3_SAVE_STATE_COMPARE)( - IN CONST struct _EFI_S3_SAVE_STATE_PROTOCOL *This, + IN CONST EFI_S3_SAVE_STATE_PROTOCOL *This, IN EFI_S3_BOOT_SCRIPT_POSITION Position1, IN EFI_S3_BOOT_SCRIPT_POSITION Position2, OUT UINTN *RelativePosition diff --git a/MdePkg/Library/BaseLib/Arm/GccInline.c b/MdePkg/Library/BaseLib/Arm/GccInline.c index 97e7d82c02..03290178e7 100644 --- a/MdePkg/Library/BaseLib/Arm/GccInline.c +++ b/MdePkg/Library/BaseLib/Arm/GccInline.c @@ -1,7 +1,7 @@ /** @file GCC inline implementation of BaseLib processor specific functions. - Copyright (c) 2006 - 2007, Intel Corporation
+ Copyright (c) 2006 - 2010, Intel Corporation
Portions copyright (c) 2008-2009 Apple Inc. All rights reserved.
All rights reserved. This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License @@ -37,11 +37,26 @@ CpuPause ( ); } +/** + Transfers control to a function starting with a new stack. + + This internal worker function transfers control to the function + specified by EntryPoint using the new stack specified by NewStack + and passing in the parameters specified by Context1 and Context2. + Context1 and Context2 are optional and may be NULL. + The function EntryPoint must never return. + + @param EntryPoint The pointer to the function to enter. + @param Context1 The first parameter to pass in. + @param Context2 The second Parameter to pass in + @param NewStack The new Location of the stack + +**/ VOID EFIAPI InternalSwitchStackAsm ( SWITCH_STACK_ENTRY_POINT EntryPoint, - VOID *Context, + VOID *Context1, VOID *Context2, VOID *NewStack ) @@ -54,7 +69,7 @@ InternalSwitchStackAsm ( "bx lr\n\t" : /* no output operand */ : "r" (EntryPoint), - "r" (Context), + "r" (Context1), "r" (Context2), "r" (NewStack) ); diff --git a/MdePkg/Library/BaseLib/Arm/InternalSwitchStack.c b/MdePkg/Library/BaseLib/Arm/InternalSwitchStack.c index 0bff206fad..3147b28bbb 100644 --- a/MdePkg/Library/BaseLib/Arm/InternalSwitchStack.c +++ b/MdePkg/Library/BaseLib/Arm/InternalSwitchStack.c @@ -1,7 +1,7 @@ /** @file SwitchStack() function for ARM. - Copyright (c) 2006 - 2007, Intel Corporation
+ Copyright (c) 2006 - 2010, Intel Corporation
Portions copyright (c) 2008-2009 Apple Inc. All rights reserved.
All rights reserved. This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License @@ -15,6 +15,21 @@ #include "BaseLibInternals.h" +/** + Transfers control to a function starting with a new stack. + + This internal worker function transfers control to the function + specified by EntryPoint using the new stack specified by NewStack + and passing in the parameters specified by Context1 and Context2. + Context1 and Context2 are optional and may be NULL. + The function EntryPoint must never return. + + @param EntryPoint The pointer to the function to enter. + @param Context1 The first parameter to pass in. + @param Context2 The second Parameter to pass in + @param NewStack The new Location of the stack + +**/ VOID EFIAPI InternalSwitchStackAsm ( diff --git a/MdePkg/Library/BaseLib/Ia32/GccInline.c b/MdePkg/Library/BaseLib/Ia32/GccInline.c index fcb0665866..d603b3f1d5 100644 --- a/MdePkg/Library/BaseLib/Ia32/GccInline.c +++ b/MdePkg/Library/BaseLib/Ia32/GccInline.c @@ -1,7 +1,7 @@ /** @file GCC inline implementation of BaseLib processor specific functions. - Copyright (c) 2006 - 2007, Intel Corporation
+ Copyright (c) 2006 - 2010, Intel Corporation
Portions copyright (c) 2008-2009 Apple Inc. All rights reserved.
All rights reserved. This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License @@ -1078,12 +1078,12 @@ InternalX86WriteGdtr ( VOID EFIAPI InternalX86ReadIdtr ( - OUT IA32_DESCRIPTOR *Ldtr + OUT IA32_DESCRIPTOR *Idtr ) { __asm__ __volatile__ ( "sldt %0" - : "=m" (*Ldtr) + : "=m" (*Idtr) ); } @@ -1100,13 +1100,13 @@ InternalX86ReadIdtr ( VOID EFIAPI InternalX86WriteIdtr ( - IN CONST IA32_DESCRIPTOR *Ldtr + IN CONST IA32_DESCRIPTOR *Idtr ) { __asm__ __volatile__ ( "lidt %0" : - : "m" (*Ldtr) + : "m" (*Idtr) ); } diff --git a/MdePkg/Library/BaseLib/Ipf/InternalSwitchStack.c b/MdePkg/Library/BaseLib/Ipf/InternalSwitchStack.c index ff11405b3d..8ff5832f0b 100644 --- a/MdePkg/Library/BaseLib/Ipf/InternalSwitchStack.c +++ b/MdePkg/Library/BaseLib/Ipf/InternalSwitchStack.c @@ -1,7 +1,7 @@ /** @file SwitchStack() function for IPF. - Copyright (c) 2007 - 2008, Intel Corporation
+ Copyright (c) 2007 - 2010, Intel Corporation
All rights reserved. This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License which accompanies this distribution. The full text of the license may be found at @@ -47,7 +47,6 @@ InternalSwitchStack ( IN VOID *NewStack, IN VA_LIST Marker ) - { VOID *NewBsp; diff --git a/MdePkg/Library/BaseLib/X64/GccInline.c b/MdePkg/Library/BaseLib/X64/GccInline.c index 2473ca9fbe..d559e3be55 100644 --- a/MdePkg/Library/BaseLib/X64/GccInline.c +++ b/MdePkg/Library/BaseLib/X64/GccInline.c @@ -1,7 +1,7 @@ /** @file GCC inline implementation of BaseLib processor specific functions. - Copyright (c) 2006 - 2007, Intel Corporation
+ Copyright (c) 2006 - 2010, Intel Corporation
Portions copyright (c) 2008-2009 Apple Inc. All rights reserved.
All rights reserved. This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License @@ -1088,12 +1088,12 @@ InternalX86WriteGdtr ( VOID EFIAPI InternalX86ReadIdtr ( - OUT IA32_DESCRIPTOR *Ldtr + OUT IA32_DESCRIPTOR *Idtr ) { __asm__ __volatile__ ( "sldt %0" - : "=m" (*Ldtr) + : "=m" (*Idtr) ); } @@ -1110,13 +1110,13 @@ InternalX86ReadIdtr ( VOID EFIAPI InternalX86WriteIdtr ( - IN CONST IA32_DESCRIPTOR *Ldtr + IN CONST IA32_DESCRIPTOR *Idtr ) { __asm__ __volatile__ ( "lidt %0" : - : "m" (*Ldtr) + : "m" (*Idtr) ); } diff --git a/MdePkg/Library/BaseMemoryLib/SetMem.c b/MdePkg/Library/BaseMemoryLib/SetMem.c index 32183d4393..2394f4878b 100644 --- a/MdePkg/Library/BaseMemoryLib/SetMem.c +++ b/MdePkg/Library/BaseMemoryLib/SetMem.c @@ -4,7 +4,7 @@ build for a particular platform easily if an optimized version is desired. - Copyright (c) 2006 - 2008, Intel Corporation
+ Copyright (c) 2006 - 2010, Intel Corporation
All rights reserved. This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License which accompanies this distribution. The full text of the license may be found at @@ -33,7 +33,7 @@ VOID * EFIAPI InternalMemSetMem ( - IN VOID *Buffer, + OUT VOID *Buffer, IN UINTN Length, IN UINT8 Value ) diff --git a/MdePkg/Library/BaseSynchronizationLib/Arm/Synchronization.c b/MdePkg/Library/BaseSynchronizationLib/Arm/Synchronization.c index e046e1b373..56f4d3c481 100644 --- a/MdePkg/Library/BaseSynchronizationLib/Arm/Synchronization.c +++ b/MdePkg/Library/BaseSynchronizationLib/Arm/Synchronization.c @@ -1,7 +1,7 @@ /** @file Implementation of synchronization functions. Still needs to be ported - Copyright (c) 2006 - 2009, Intel Corporation
+ Copyright (c) 2006 - 2010, Intel Corporation
Portions copyright (c) 2008-2009 Apple Inc. All rights reserved.
All rights reserved. This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License @@ -13,6 +13,23 @@ **/ +/** + Performs an atomic compare exchange operation on a 32-bit unsigned integer. + + Performs an atomic compare exchange operation on the 32-bit unsigned integer + specified by Value. If Value is equal to CompareValue, then Value is set to + ExchangeValue and CompareValue is returned. If Value is not equal to CompareValue, + then Value is returned. The compare exchange operation must be performed using + MP safe mechanisms. + + @param Value A pointer to the 32-bit value for the compare exchange + operation. + @param CompareValue 32-bit value used in compare operation. + @param ExchangeValue 32-bit value used in exchange operation. + + @return The original *Value before exchange. + +**/ UINT32 EFIAPI InternalSyncCompareExchange32 ( diff --git a/MdePkg/Library/DxeServicesLib/DxeServicesLib.c b/MdePkg/Library/DxeServicesLib/DxeServicesLib.c index e44833f19f..bd7b95c400 100644 --- a/MdePkg/Library/DxeServicesLib/DxeServicesLib.c +++ b/MdePkg/Library/DxeServicesLib/DxeServicesLib.c @@ -2,7 +2,7 @@ MDE DXE Services Library provides functions that simplify the development of DXE Drivers. These functions help access data from sections of FFS files or from file path. - Copyright (c) 2007 - 2009, Intel Corporation
+ Copyright (c) 2007 - 2010, Intel Corporation
All rights reserved. This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License which accompanies this distribution. The full text of the license may be found at @@ -401,7 +401,7 @@ GetSectionFromFfs ( /** Get the image file buffer data and buffer size by its device path. - Access the file either from a a firmware volume, from a file system interface, + Access the file either from a firmware volume, from a file system interface, or from the load file interface. Allocate memory to store the found image. The caller is responsible to free memory. @@ -410,16 +410,15 @@ GetSectionFromFfs ( If FileSize is NULL, then NULL is returned. If AuthenticationStatus is NULL, then NULL is returned. - @param[in] BootPolicy - Policy for Open Image File.If TRUE, indicates that the request - originates from the boot manager, and that the boot manager is - attempting to load FilePath as a boot selection. If FALSE, - then FilePath must match an exact file to be loaded. - @param[in] FilePath Pointer to the device path of the file that is absracted to the file buffer. - @param[out] FileSize Pointer to the size of the abstracted file buffer. - @param[out] AuthenticationStatus - Pointer to a caller-allocated UINT32 in which - the authentication status is returned. + @param[in] BootPolicy Policy for Open Image File.If TRUE, indicates that the request + originates from the boot manager, and that the boot manager is + attempting to load FilePath as a boot selection. If FALSE, + then FilePath must match an exact file to be loaded. + @param[in] FilePath Pointer to the device path of the file that is absracted to + the file buffer. + @param[out] FileSize Pointer to the size of the abstracted file buffer. + @param[out] AuthenticationStatus Pointer to a caller-allocated UINT32 in which the authentication + status is returned. @retval NULL File is NULL, or FileSize is NULL. Or the file can't be found. @retval other The abstracted file buffer. The caller is responsible to free memory.