VirtualBox

Ignore:
Timestamp:
Oct 29, 2015 4:30:44 AM (9 years ago)
Author:
vboxsync
Message:

EFI/Firmware: Merged in the svn:eol-style, svn:mime-type and trailing whitespace cleanup that was done after the initial UDK2014.SP1 import: svn merge /vendor/edk2/UDK2014.SP1 /vendor/edk2/current .

Location:
trunk/src/VBox/Devices/EFI/Firmware
Files:
18 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/VBox/Devices/EFI/Firmware

  • trunk/src/VBox/Devices/EFI/Firmware/IntelFrameworkPkg/Library/DxeIoLibCpuIo/DxeCpuIoLibInternal.h

    r48674 r58466  
    22  Internal include file of DXE CPU IO Library.
    33  It includes all necessary protocol/library class's header file
    4   for implementation of IoLib library instance. It is included 
     4  for implementation of IoLib library instance. It is included
    55  all source code of this library instance.
    6  
     6
    77  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>
    88  This program and the accompanying materials
    … …  
    108108  @param  Width         The width of the I/O operation.
    109109  @param  Data          The value to write to the I/O port.
    110  
     110
    111111  @return Data read from registers in the EFI system memory space.
    112112

  • trunk/src/VBox/Devices/EFI/Firmware/IntelFrameworkPkg/Library/DxeIoLibCpuIo/IoLib.c

    r48674 r58466  
    11/** @file
    22  I/O Library.
    3   The implementation of I/O operation for this library instance 
     3  The implementation of I/O operation for this library instance
    44  are based on EFI_CPU_IO_PROTOCOL.
    5  
     5
    66  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>
    77  This program and the accompanying materials
    … …  
    154154  @param  Width         The width of the I/O operation.
    155155  @param  Data          The value to write to the I/O port.
    156  
     156
    157157  @return Data read from registers in the EFI system memory space.
    158158
    … …  
    230230
    231231  If Port is not aligned on a 16-bit boundary, then ASSERT().
    232  
     232
    233233  If 16-bit I/O port operations are not supported, then ASSERT().
    234234
    … …  
    288288  This function must guarantee that all I/O read and write operations are
    289289  serialized.
    290  
     290
    291291  If Port is not aligned on a 32-bit boundary, then ASSERT().
    292292
    … …  
    379379
    380380  If Port is not aligned on a 64-bit boundary, then ASSERT().
    381  
     381
    382382  If 64-bit I/O port operations are not supported, then ASSERT().
    383383
    … …  
    456456
    457457  If Address is not aligned on a 16-bit boundary, then ASSERT().
    458  
     458
    459459  If 16-bit MMIO register operations are not supported, then ASSERT().
    460460
    … …  
    485485
    486486  If Address is not aligned on a 16-bit boundary, then ASSERT().
    487  
     487
    488488  If 16-bit MMIO register operations are not supported, then ASSERT().
    489489
    … …  
    514514
    515515  If Address is not aligned on a 32-bit boundary, then ASSERT().
    516  
     516
    517517  If 32-bit MMIO register operations are not supported, then ASSERT().
    518518
    … …  
    543543
    544544  If Address is not aligned on a 32-bit boundary, then ASSERT().
    545  
     545
    546546  If 32-bit MMIO register operations are not supported, then ASSERT().
    547547
    … …  
    572572
    573573  If Address is not aligned on a 64-bit boundary, then ASSERT().
    574  
     574
    575575  If 64-bit MMIO register operations are not supported, then ASSERT().
    576576
    … …  
    601601
    602602  If Address is not aligned on a 64-bit boundary, then ASSERT().
    603  
     603
    604604  If 64-bit MMIO register operations are not supported, then ASSERT().
    605605

  • trunk/src/VBox/Devices/EFI/Firmware/IntelFrameworkPkg/Library/DxeIoLibCpuIo/IoLibMmioBuffer.c

    r48674 r58466  
    7171
    7272  If Length is not aligned on a 16-bit boundary, then ASSERT().
    73  
     73
    7474  If Buffer is not aligned on a 16-bit boundary, then ASSERT().
    7575
    … …  
    174174
    175175  If Length is not aligned on a 64-bit boundary, then ASSERT().
    176  
     176
    177177  If Buffer is not aligned on a 64-bit boundary, then ASSERT().
    178178

  • trunk/src/VBox/Devices/EFI/Firmware/IntelFrameworkPkg/Library/DxeSmmDriverEntryPoint/DriverEntryPoint.c

    r48674 r58466  
    137137  //
    138138  // Call the unload handlers for all the modules.
    139   // 
    140   // Note: All libraries were constructed in SMM space, 
    141   // therefore we can not destruct them in Unload 
     139  //
     140  // Note: All libraries were constructed in SMM space,
     141  // therefore we can not destruct them in Unload
    142142  // handler.
    143143  //

  • trunk/src/VBox/Devices/EFI/Firmware/IntelFrameworkPkg/Library/DxeSmmDriverEntryPoint/DxeSmmDriverEntryPoint.inf

    r58459 r58466  
    5050  gEfiSmmBaseProtocolGuid                       ## CONSUMES
    5151  gEfiDevicePathProtocolGuid                    ## CONSUMES
    52  
     52
    5353[Depex]
    5454  gEfiSmmBaseProtocolGuid

  • trunk/src/VBox/Devices/EFI/Firmware/IntelFrameworkPkg/Library/FrameworkUefiLib/Console.c

    r58459 r58466  
    33
    44  Copyright (c) 2006 - 2012, Intel Corporation. All rights reserved.<BR>
    5   This program and the accompanying materials                         
    6   are licensed and made available under the terms and conditions of the BSD License         
    7   which accompanies this distribution.  The full text of the license may be found at       
    8   http://opensource.org/licenses/bsd-license.php                                           
    9 
    10   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     
    11   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             
     5  This program and the accompanying materials
     6  are licensed and made available under the terms and conditions of the BSD License
     7  which accompanies this distribution.  The full text of the license may be found at
     8  http://opensource.org/licenses/bsd-license.php
     9
     10  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
     11  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
    1212
    1313**/
    … …  
    2929  {(CHAR16)0x1FFF,  1},
    3030  /*
    31    * Merge the blocks and replace them with the above entry as they fall to 
     31   * Merge the blocks and replace them with the above entry as they fall to
    3232   * the same category and they are all narrow glyph. This will reduce search
    3333   * time and table size. The merge will omit the reserved code.
    … …  
    7676  {(CHAR16)0x2FFF,  1},
    7777  /*
    78    * Merge the blocks and replace them with the above entry as they fall to 
     78   * Merge the blocks and replace them with the above entry as they fall to
    7979   * the same category and they are all narrow glyph. This will reduce search
    8080   * time and table size. The merge will omit the reserved code.
    … …  
    108108  {(CHAR16)0x33FF,  2},
    109109  /*
    110    * Merge the blocks and replace them with the above entry as they fall to 
     110   * Merge the blocks and replace them with the above entry as they fall to
    111111   * the same category and they are all wide glyph. This will reduce search
    112112   * time and table size. The merge will omit the reserved code.
    … …  
    131131  {(CHAR16)0x9FFF,  2},
    132132  /*
    133    * Merge the blocks and replace them with the above entry as they fall to 
     133   * Merge the blocks and replace them with the above entry as they fall to
    134134   * the same category and they are all wide glyph. This will reduce search
    135135   * time and table size. The merge will omit the reserved code.
    … …  
    137137   * Remove the above item if below is un-commented.
    138138   *
    139   {(CHAR16)0x4DFF,  0},       // Reserved. 0x3400-0x4DBF as CJK unified ideographs 
     139  {(CHAR16)0x4DFF,  0},       // Reserved. 0x3400-0x4DBF as CJK unified ideographs
    140140                      // extension A in ver3.0. 0x3400-0x4DFF
    141141  {(CHAR16)0x9FFF,  2},       // CJK unified ideographs. 0x4E00-0x9FFF
    … …  
    153153  {(CHAR16)0xD7FF,  2},
    154154  /*
    155    * Merge the blocks and replace them with the above entry as they fall to 
     155   * Merge the blocks and replace them with the above entry as they fall to
    156156   * the same category and they are all wide glyph. This will reduce search
    157157   * time and table size. The merge will omit the reserved code.
    … …  
    216216  Low   = 0;
    217217  High  = (sizeof (mUnicodeWidthTable)) / (sizeof (UNICODE_WIDTH_ENTRY)) - 1;
    218   while (Low <= High) {   
     218  while (Low <= High) {
    219219    Index = (Low + High) >> 1;
    220220    Item  = &(mUnicodeWidthTable[Index]);
    … …  
    254254  width of String can be computed by summing the display widths of each Unicode character
    255255  in String.  Unicode characters that are narrow glyphs have a width of 1, and Unicode
    256   characters that are width glyphs have a width of 2. 
     256  characters that are width glyphs have a width of 2.
    257257  If String is not aligned on a 16-bit boundary, then ASSERT().
    258258
    … …  
    260260
    261261  @return          The display length of the Null-terminated Unicode string specified by String.
    262  
     262
    263263**/
    264264UINTN
    … …  
    290290
    291291/**
    292   Draws a dialog box to the console output device specified by 
     292  Draws a dialog box to the console output device specified by
    293293  ConOut defined in the EFI_SYSTEM_TABLE and waits for a keystroke
    294   from the console input device specified by ConIn defined in the 
     294  from the console input device specified by ConIn defined in the
    295295  EFI_SYSTEM_TABLE.
    296296
    … …  
    299299
    300300  @param[in]   Attribute  Specifies the foreground and background color of the popup.
    301   @param[out]  Key        A pointer to the EFI_KEY value of the key that was 
     301  @param[out]  Key        A pointer to the EFI_KEY value of the key that was
    302302                          pressed.  This is an optional parameter that may be NULL.
    303303                          If it is NULL then no wait for a keypress will be performed.
    304304  @param[in]  ...         The variable argument list that contains pointers to Null-
    305                           terminated Unicode strings to display in the dialog box. 
     305                          terminated Unicode strings to display in the dialog box.
    306306                          The variable argument list is terminated by a NULL.
    307307
    … …  
    310310EFIAPI
    311311CreatePopUp (
    312   IN  UINTN          Attribute,               
     312  IN  UINTN          Attribute,
    313313  OUT EFI_INPUT_KEY  *Key,      OPTIONAL
    314314  ...
    … …  
    331331
    332332  //
    333   // Determine the length of the longest line in the popup and the the total 
     333  // Determine the length of the longest line in the popup and the the total
    334334  // number of lines in the popup
    335335  //
    … …  
    357357  //
    358358  ConOut = gST->ConOut;
    359  
     359
    360360  //
    361361  // Save the current console cursor position and attributes
    … …  
    397397
    398398  //
    399   // Draw top of popup box   
     399  // Draw top of popup box
    400400  //
    401401  SetMem16 (Line, (MaxLength + 2) * 2, BOXDRAW_HORIZONTAL);

  • trunk/src/VBox/Devices/EFI/Firmware/IntelFrameworkPkg/Library/FrameworkUefiLib/FrameworkUefiLib.inf

    r58459 r58466  
    22#  Library to abstract Framework extensions that conflict with UEFI 2.0 Specification.
    33#
    4 #  This library is helpful to port Framework/Tinao code that has conflicts with UEFI 2.0. 
     4#  This library is helpful to port Framework/Tinao code that has conflicts with UEFI 2.0.
    55#  It hides the old conflicts with library functions and supporting implementations of
    66#  the old (EDK/EFI 1.10) and new (EDK II/UEFI 2.0) way.
    … …  
    5252  UefiBootServicesTableLib
    5353  DevicePathLib
    54  
     54
    5555[Guids]
    5656  gEfiEventReadyToBootGuid                      ## SOMETIMES_CONSUMES  ## Event

  • trunk/src/VBox/Devices/EFI/Firmware/IntelFrameworkPkg/Library/FrameworkUefiLib/UefiDriverModel.c

    r58459 r58466  
    88  which accompanies this distribution.  The full text of the license may be found at
    99  http://opensource.org/licenses/bsd-license.php
    10  
     10
    1111  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
    1212  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
    1313
    14 **/ 
     14**/
    1515
    1616
    … …  
    1919/**
    2020  Installs and completes the initialization of a Driver Binding Protocol instance.
    21  
     21
    2222  Installs the Driver Binding Protocol specified by DriverBinding onto the handle
    2323  specified by DriverBindingHandle. If DriverBindingHandle is NULL, then DriverBinding
    2424  is installed onto a newly created handle. DriverBindingHandle is typically the same
    2525  as the driver's ImageHandle, but it can be different if the driver produces multiple
    26   Driver Binding Protocols. 
    27   If DriverBinding is NULL, then ASSERT(). 
     26  Driver Binding Protocols.
     27  If DriverBinding is NULL, then ASSERT().
    2828  If DriverBinding can not be installed onto a handle, then ASSERT().
    2929
    … …  
    8181  then the protocols are  installed onto a newly created handle. DriverBindingHandle
    8282  is typically the same as the driver's ImageHandle, but it can be different if the
    83   driver produces multiple Driver Binding Protocols. 
    84   If DriverBinding is NULL, then ASSERT(). 
     83  driver produces multiple Driver Binding Protocols.
     84  If DriverBinding is NULL, then ASSERT().
    8585  If the installation fails, then ASSERT().
    86  
     86
    8787  @param  ImageHandle          The image handle of the driver.
    8888  @param  SystemTable          The EFI System Table that was passed to the driver's entry point.
    … …  
    211211  DriverBindingHandle.  If DriverBindingHandle is NULL, then the protocols are installed
    212212  onto a newly created handle.  DriverBindingHandle is typically the same as the driver's
    213   ImageHandle, but it can be different if the driver produces multiple Driver Binding Protocols. 
    214   If DriverBinding is NULL, then ASSERT(). 
     213  ImageHandle, but it can be different if the driver produces multiple Driver Binding Protocols.
     214  If DriverBinding is NULL, then ASSERT().
    215215  If the installation fails, then ASSERT().
    216216
    … …  
    300300  optional Driver Diagnostic, and optional Driver Diagnostic 2 Protocols onto the driver's DriverBindingHandle.
    301301  DriverBindingHandle is typically the same as the driver's ImageHandle, but it can be different if the driver
    302   produces multiple Driver Binding Protocols. 
    303   If DriverBinding is NULL, then ASSERT(). 
     302  produces multiple Driver Binding Protocols.
     303  If DriverBinding is NULL, then ASSERT().
    304304  If the installation fails, then ASSERT().
    305305
    … …  
    338338  EFI_STATUS  Status;
    339339
    340   ASSERT (DriverBinding != NULL); 
     340  ASSERT (DriverBinding != NULL);
    341341
    342342  //
    … …  
    345345  DriverBinding->ImageHandle         = ImageHandle;
    346346  DriverBinding->DriverBindingHandle = DriverBindingHandle;
    347  
     347
    348348  if (DriverConfiguration2 == NULL) {
    349349    if (DriverConfiguration == NULL) {

  • trunk/src/VBox/Devices/EFI/Firmware/IntelFrameworkPkg/Library/FrameworkUefiLib/UefiLib.c

    r48674 r58466  
    11/** @file
    2   The UEFI Library provides functions and macros that simplify the development of 
    3   UEFI Drivers and UEFI Applications.  These functions and macros help manage EFI 
    4   events, build simple locks utilizing EFI Task Priority Levels (TPLs), install 
    5   EFI Driver Model related protocols, manage Unicode string tables for UEFI Drivers, 
     2  The UEFI Library provides functions and macros that simplify the development of
     3  UEFI Drivers and UEFI Applications.  These functions and macros help manage EFI
     4  events, build simple locks utilizing EFI Task Priority Levels (TPLs), install
     5  EFI Driver Model related protocols, manage Unicode string tables for UEFI Drivers,
    66  and print messages on the console output and standard error devices.
    77
    … …  
    4848  Retrieves a pointer to the system configuration table from the EFI System Table
    4949  based on a specified GUID.
    50  
     50
    5151  This function searches the list of configuration tables stored in the EFI System Table
    5252  for a table with a GUID that matches TableGuid.  If a match is found, then a pointer to
    … …  
    9797  then the notification function is still executed one time. In addition, every time a protocol
    9898  of type ProtocolGuid instance is installed or reinstalled, the notification function is also
    99   executed. This function returns the notification event that was created. 
     99  executed. This function returns the notification event that was created.
    100100  If ProtocolGuid is NULL, then ASSERT().
    101101  If NotifyTpl is not a legal TPL value, then ASSERT().
    … …  
    110110  @param  Registration    A pointer to a memory location to receive the registration value.
    111111                          This value is passed to LocateHandle() to obtain new handles that
    112                           have been added that support the ProtocolGuid-specified protocol. 
     112                          have been added that support the ProtocolGuid-specified protocol.
    113113
    114114  @return The notification event that was created.
    … …  
    171171  This function creates an event using NotifyTpl, NoifyFunction, and NotifyContext.
    172172  This event is signaled with EfiNamedEventSignal(). This provides the ability for one or more
    173   listeners on the same event named by the GUID specified by Name. 
     173  listeners on the same event named by the GUID specified by Name.
    174174  If Name is NULL, then ASSERT().
    175175  If NotifyTpl is not a legal TPL value, then ASSERT().
    … …  
    179179  @param  NotifyTpl             Supplies the task priority level of the event notifications.
    180180  @param  NotifyFunction        Supplies the function to notify when the event is signaled.
    181   @param  NotifyContext         The context parameter to pass to NotifyFunction. 
     181  @param  NotifyContext         The context parameter to pass to NotifyFunction.
    182182  @param  Registration          A pointer to a memory location to receive the registration value.
    183183
    … …  
    203203  ASSERT (NotifyFunction != NULL);
    204204  ASSERT (NotifyTpl <= TPL_HIGH_LEVEL);
    205  
     205
    206206  //
    207207  // Create event
    … …  
    283283}
    284284
    285 /** 
     285/**
    286286  Returns the current TPL.
    287287
    288   This function returns the current TPL.  There is no EFI service to directly 
    289   retrieve the current TPL. Instead, the RaiseTPL() function is used to raise 
    290   the TPL to TPL_HIGH_LEVEL.  This will return the current TPL.  The TPL level 
    291   can then immediately be restored back to the current TPL level with a call 
     288  This function returns the current TPL.  There is no EFI service to directly
     289  retrieve the current TPL. Instead, the RaiseTPL() function is used to raise
     290  the TPL to TPL_HIGH_LEVEL.  This will return the current TPL.  The TPL level
     291  can then immediately be restored back to the current TPL level with a call
    292292  to RestoreTPL().
    293293
    … …  
    313313  Initializes a basic mutual exclusion lock.
    314314
    315   This function initializes a basic mutual exclusion lock to the released state 
    316   and returns the lock.  Each lock provides mutual exclusion access at its task 
     315  This function initializes a basic mutual exclusion lock to the released state
     316  and returns the lock.  Each lock provides mutual exclusion access at its task
    317317  priority level.  Since there is no preemption or multiprocessor support in EFI,
    318318  acquiring the lock only consists of raising to the locks TPL.
    … …  
    345345  Acquires ownership of a lock.
    346346
    347   This function raises the system's current task priority level to the task 
    348   priority level of the mutual exclusion lock.  Then, it places the lock in the 
     347  This function raises the system's current task priority level to the task
     348  priority level of the mutual exclusion lock.  Then, it places the lock in the
    349349  acquired state.
    350350  If Lock is NULL, then ASSERT().
    … …  
    411411  Releases ownership of a lock.
    412412
    413   This function transitions a mutual exclusion lock from the acquired state to 
    414   the released state, and restores the system's task priority level to its 
     413  This function transitions a mutual exclusion lock from the acquired state to
     414  the released state, and restores the system's task priority level to its
    415415  previous level.
    416416  If Lock is NULL, then ASSERT().
    … …  
    446446  is performed by evaluating if the the protocol specified by ProtocolGuid is
    447447  present on ControllerHandle and is was opened by DriverBindingHandle with an
    448   attribute of EFI_OPEN_PROTOCOL_BY_DRIVER. 
     448  attribute of EFI_OPEN_PROTOCOL_BY_DRIVER.
    449449  If ProtocolGuid is NULL, then ASSERT().
    450450
    … …  
    509509  If ProtocolGuid is NULL, then ASSERT().
    510510
    511   @param  ControllerHandle     A handle for a (parent) controller to test. 
     511  @param  ControllerHandle     A handle for a (parent) controller to test.
    512512  @param  ChildHandle          A child handle to test.
    513513  @param  ProtocolGuid         Supplies the protocol that the child controller
    514                                opens on its parent controller. 
     514                               opens on its parent controller.
    515515
    516516  @retval EFI_SUCCESS          ChildHandle is a child of the ControllerHandle.
    … …  
    571571  is returned in UnicodeString.
    572572
    573   @param  Language                A pointer to the ISO 639-2 language code for the 
     573  @param  Language                A pointer to the ISO 639-2 language code for the
    574574                                  Unicode string to look up and return.
    575   @param  SupportedLanguages      A pointer to the set of ISO 639-2 language codes 
    576                                   that the Unicode string table supports.  Language 
     575  @param  SupportedLanguages      A pointer to the set of ISO 639-2 language codes
     576                                  that the Unicode string table supports.  Language
    577577                                  must be a member of this set.
    578578  @param  UnicodeStringTable      A pointer to the table of Unicode strings.
    … …  
    580580                                  that matches the language specified by Language.
    581581
    582   @retval EFI_SUCCESS             The Unicode string that matches the language 
     582  @retval EFI_SUCCESS             The Unicode string that matches the language
    583583                                  specified by Language was found
    584                                   in the table of Unicode strings UnicodeStringTable, 
     584                                  in the table of Unicode strings UnicodeStringTable,
    585585                                  and it was returned in UnicodeString.
    586586  @retval EFI_INVALID_PARAMETER   Language is NULL.
    … …  
    588588  @retval EFI_UNSUPPORTED         SupportedLanguages is NULL.
    589589  @retval EFI_UNSUPPORTED         UnicodeStringTable is NULL.
    590   @retval EFI_UNSUPPORTED         The language specified by Language is not a 
     590  @retval EFI_UNSUPPORTED         The language specified by Language is not a
    591591                                  member of SupportedLanguages.
    592   @retval EFI_UNSUPPORTED         The language specified by Language is not 
     592  @retval EFI_UNSUPPORTED         The language specified by Language is not
    593593                                  supported by UnicodeStringTable.
    594594
    … …  
    663663                               not assumed to be Null-terminated, and only the first three
    664664                               characters are used. If Iso639Language is FALSE, then this ASCII
    665                                string must be Null-terminated. 
     665                               string must be Null-terminated.
    666666  @param  SupportedLanguages   A pointer to a Null-terminated ASCII string that contains a
    667667                               set of ISO 639-2 or RFC 4646 language codes that the Unicode
    … …  
    683683                                  was found in the table of Unicode strings UnicodeStringTable, and
    684684                                  it was returned in UnicodeString.
    685   @retval  EFI_INVALID_PARAMETER  Language is NULL. 
    686   @retval  EFI_INVALID_PARAMETER  UnicodeString is NULL. 
    687   @retval  EFI_UNSUPPORTED        SupportedLanguages is NULL. 
    688   @retval  EFI_UNSUPPORTED        UnicodeStringTable is NULL. 
    689   @retval  EFI_UNSUPPORTED        The language specified by Language is not a member of SupportedLanguages. 
     685  @retval  EFI_INVALID_PARAMETER  Language is NULL.
     686  @retval  EFI_INVALID_PARAMETER  UnicodeString is NULL.
     687  @retval  EFI_UNSUPPORTED        SupportedLanguages is NULL.
     688  @retval  EFI_UNSUPPORTED        UnicodeStringTable is NULL.
     689  @retval  EFI_UNSUPPORTED        The language specified by Language is not a member of SupportedLanguages.
    690690  @retval  EFI_UNSUPPORTED        The language specified by Language is not supported by UnicodeStringTable.
    691691
    … …  
    773773  This function adds a Unicode string to UnicodeStringTable.
    774774
    775   If Language is a member of SupportedLanguages then UnicodeString is added to 
    776   UnicodeStringTable.  New buffers are allocated for both Language and 
    777   UnicodeString.  The contents of Language and UnicodeString are copied into 
    778   these new buffers.  These buffers are automatically freed when 
     775  If Language is a member of SupportedLanguages then UnicodeString is added to
     776  UnicodeStringTable.  New buffers are allocated for both Language and
     777  UnicodeString.  The contents of Language and UnicodeString are copied into
     778  these new buffers.  These buffers are automatically freed when
    779779  FreeUnicodeStringTable() is called.
    780780
    781   @param  Language                A pointer to the ISO 639-2 language code for the Unicode 
     781  @param  Language                A pointer to the ISO 639-2 language code for the Unicode
    782782                                  string to add.
    783783  @param  SupportedLanguages      A pointer to the set of ISO 639-2 language codes
    … …  
    787787  @param  UnicodeString           A pointer to the Unicode string to add.
    788788
    789   @retval EFI_SUCCESS             The Unicode string that matches the language 
    790                                   specified by Language was found in the table of 
    791                                   Unicode strings UnicodeStringTable, and it was 
     789  @retval EFI_SUCCESS             The Unicode string that matches the language
     790                                  specified by Language was found in the table of
     791                                  Unicode strings UnicodeStringTable, and it was
    792792                                  returned in UnicodeString.
    793793  @retval EFI_INVALID_PARAMETER   Language is NULL.
    … …  
    795795  @retval EFI_INVALID_PARAMETER   UnicodeString is an empty string.
    796796  @retval EFI_UNSUPPORTED         SupportedLanguages is NULL.
    797   @retval EFI_ALREADY_STARTED     A Unicode string with language Language is 
     797  @retval EFI_ALREADY_STARTED     A Unicode string with language Language is
    798798                                  already present in UnicodeStringTable.
    799   @retval EFI_OUT_OF_RESOURCES    There is not enough memory to add another 
     799  @retval EFI_OUT_OF_RESOURCES    There is not enough memory to add another
    800800                                  Unicode string to UnicodeStringTable.
    801   @retval EFI_UNSUPPORTED         The language specified by Language is not a 
     801  @retval EFI_UNSUPPORTED         The language specified by Language is not a
    802802                                  member of SupportedLanguages.
    803803
    … …  
    962962  @param  UnicodeStringTable  A pointer to the table of Unicode strings. Type EFI_UNICODE_STRING_TABLE
    963963                              is defined in "Related Definitions".
    964   @param  UnicodeString       A pointer to the Unicode string to add. 
     964  @param  UnicodeString       A pointer to the Unicode string to add.
    965965  @param  Iso639Language      Specifies the supported language code format. If it is TRUE,
    966966                              then Language and SupportedLanguages follow ISO 639-2 language code format.
    … …  
    969969  @retval EFI_SUCCESS            The Unicode string that matches the language specified by
    970970                                 Language was found in the table of Unicode strings UnicodeStringTable,
    971                                  and it was returned in UnicodeString. 
    972   @retval EFI_INVALID_PARAMETER  Language is NULL. 
    973   @retval EFI_INVALID_PARAMETER  UnicodeString is NULL. 
    974   @retval EFI_INVALID_PARAMETER  UnicodeString is an empty string. 
    975   @retval EFI_UNSUPPORTED        SupportedLanguages is NULL. 
     971                                 and it was returned in UnicodeString.
     972  @retval EFI_INVALID_PARAMETER  Language is NULL.
     973  @retval EFI_INVALID_PARAMETER  UnicodeString is NULL.
     974  @retval EFI_INVALID_PARAMETER  UnicodeString is an empty string.
     975  @retval EFI_UNSUPPORTED        SupportedLanguages is NULL.
    976976  @retval EFI_ALREADY_STARTED    A Unicode string with language Language is already present in
    977                                  UnicodeStringTable. 
    978   @retval EFI_OUT_OF_RESOURCES   There is not enough memory to add another Unicode string UnicodeStringTable. 
     977                                 UnicodeStringTable.
     978  @retval EFI_OUT_OF_RESOURCES   There is not enough memory to add another Unicode string UnicodeStringTable.
    979979  @retval EFI_UNSUPPORTED        The language specified by Language is not a member of SupportedLanguages.
    980980
    … …  
    10601060        for (Index = 0; LanguageString[Index] != 0 && LanguageString[Index] != ';'; Index++);
    10611061
    1062         if (AsciiStrnCmp (Language, LanguageString, Index) == 0) { 
     1062        if (AsciiStrnCmp (Language, LanguageString, Index) == 0) {
    10631063          return EFI_ALREADY_STARTED;
    10641064        }
    … …  
    11421142
    11431143  If UnicodeStringTable is NULL, then EFI_SUCCESS is returned.
    1144   Otherwise, each language code, and each Unicode string in the Unicode string 
     1144  Otherwise, each language code, and each Unicode string in the Unicode string
    11451145  table are freed, and EFI_SUCCESS is returned.
    11461146
    … …  
    11921192
    11931193/**
    1194   Returns a pointer to an allocated buffer that contains the contents of a 
    1195   variable retrieved through the UEFI Runtime Service GetVariable().  The 
     1194  Returns a pointer to an allocated buffer that contains the contents of a
     1195  variable retrieved through the UEFI Runtime Service GetVariable().  The
    11961196  returned buffer is allocated using AllocatePool().  The caller is responsible
    11971197  for freeing this buffer with FreePool().
    … …  
    12541254
    12551255/**
    1256   Returns a pointer to an allocated buffer that contains the contents of a 
    1257   variable retrieved through the UEFI Runtime Service GetVariable().  This 
     1256  Returns a pointer to an allocated buffer that contains the contents of a
     1257  variable retrieved through the UEFI Runtime Service GetVariable().  This
    12581258  function always uses the EFI_GLOBAL_VARIABLE GUID to retrieve variables.
    1259   The returned buffer is allocated using AllocatePool().  The caller is 
     1259  The returned buffer is allocated using AllocatePool().  The caller is
    12601260  responsible for freeing this buffer with FreePool().
    12611261
    … …  
    12801280
    12811281/**
    1282   Returns a pointer to an allocated buffer that contains the best matching language 
    1283   from a set of supported languages. 
    1284  
    1285   This function supports both ISO 639-2 and RFC 4646 language codes, but language 
    1286   code types may not be mixed in a single call to this function.  The language 
    1287   code returned is allocated using AllocatePool().  The caller is responsible for 
     1282  Returns a pointer to an allocated buffer that contains the best matching language
     1283  from a set of supported languages.
     1284
     1285  This function supports both ISO 639-2 and RFC 4646 language codes, but language
     1286  code types may not be mixed in a single call to this function.  The language
     1287  code returned is allocated using AllocatePool().  The caller is responsible for
    12881288  freeing the allocated buffer using FreePool().  This function supports a variable
    1289   argument list that allows the caller to pass in a prioritized list of language 
    1290   codes to test against all the language codes in SupportedLanguages. 
     1289  argument list that allows the caller to pass in a prioritized list of language
     1290  codes to test against all the language codes in SupportedLanguages.
    12911291
    12921292  If SupportedLanguages is NULL, then ASSERT().
    12931293
    12941294  @param[in]  SupportedLanguages  A pointer to a Null-terminated ASCII string that
    1295                                   contains a set of language codes in the format 
     1295                                  contains a set of language codes in the format
    12961296                                  specified by Iso639Language.
    12971297  @param[in]  Iso639Language      If TRUE, then all language codes are assumed to be
    12981298                                  in ISO 639-2 format.  If FALSE, then all language
    12991299                                  codes are assumed to be in RFC 4646 language format
    1300   @param[in]  ...                 A variable argument list that contains pointers to 
     1300  @param[in]  ...                 A variable argument list that contains pointers to
    13011301                                  Null-terminated ASCII strings that contain one or more
    13021302                                  language codes in the format specified by Iso639Language.
    13031303                                  The first language code from each of these language
    13041304                                  code lists is used to determine if it is an exact or
    1305                                   close match to any of the language codes in 
     1305                                  close match to any of the language codes in
    13061306                                  SupportedLanguages.  Close matches only apply to RFC 4646
    13071307                                  language codes, and the matching algorithm from RFC 4647
    1308                                   is used to determine if a close match is present.  If 
     1308                                  is used to determine if a close match is present.  If
    13091309                                  an exact or close match is found, then the matching
    13101310                                  language code from SupportedLanguages is returned.  If
    13111311                                  no matches are found, then the next variable argument
    1312                                   parameter is evaluated.  The variable argument list 
     1312                                  parameter is evaluated.  The variable argument list
    13131313                                  is terminated by a NULL.
    13141314
    13151315  @retval NULL   The best matching language could not be found in SupportedLanguages.
    1316   @retval NULL   There are not enough resources available to return the best matching 
     1316  @retval NULL   There are not enough resources available to return the best matching
    13171317                 language.
    1318   @retval Other  A pointer to a Null-terminated ASCII string that is the best matching 
     1318  @retval Other  A pointer to a Null-terminated ASCII string that is the best matching
    13191319                 language in SupportedLanguages.
    13201320
    … …  
    13231323EFIAPI
    13241324GetBestLanguage (
    1325   IN CONST CHAR8  *SupportedLanguages, 
     1325  IN CONST CHAR8  *SupportedLanguages,
    13261326  IN BOOLEAN      Iso639Language,
    13271327  ...
    … …  
    14021402      } else {
    14031403        //
    1404         // If RFC 4646 mode, then trim Language from the right to the next '-' character 
     1404        // If RFC 4646 mode, then trim Language from the right to the next '-' character
    14051405        //
    14061406        for (LanguageLength--; LanguageLength > 0 && Language[LanguageLength] != '-'; LanguageLength--);
    … …  
    14111411
    14121412  //
    1413   // No matches were found 
     1413  // No matches were found
    14141414  //
    14151415  return NULL;

  • trunk/src/VBox/Devices/EFI/Firmware/IntelFrameworkPkg/Library/FrameworkUefiLib/UefiLibPrint.c

    r58459 r58466  
    9191}
    9292
    93 /** 
    94   Prints a formatted Unicode string to the console output device specified by 
     93/**
     94  Prints a formatted Unicode string to the console output device specified by
    9595  ConOut defined in the EFI_SYSTEM_TABLE.
    9696
    97   This function prints a formatted Unicode string to the console output device 
    98   specified by ConOut in EFI_SYSTEM_TABLE and returns the number of Unicode 
    99   characters that printed to ConOut.  If the length of the formatted Unicode 
    100   string is greater than PcdUefiLibMaxPrintBufferSize, then only the first 
     97  This function prints a formatted Unicode string to the console output device
     98  specified by ConOut in EFI_SYSTEM_TABLE and returns the number of Unicode
     99  characters that printed to ConOut.  If the length of the formatted Unicode
     100  string is greater than PcdUefiLibMaxPrintBufferSize, then only the first
    101101  PcdUefiLibMaxPrintBufferSize characters are sent to ConOut.
    102102  If Format is NULL, then ASSERT().
    … …  
    105105
    106106  @param Format   Null-terminated Unicode format string.
    107   @param ...      Variable argument list whose contents are accessed based 
     107  @param ...      Variable argument list whose contents are accessed based
    108108                  on the format string specified by Format.
    109  
     109
    110110  @return Number of Unicode characters printed to ConOut.
    111111
    … …  
    130130}
    131131
    132 /** 
    133   Prints a formatted Unicode string to the console output device specified by 
     132/**
     133  Prints a formatted Unicode string to the console output device specified by
    134134  StdErr defined in the EFI_SYSTEM_TABLE.
    135135
    136   This function prints a formatted Unicode string to the console output device 
    137   specified by StdErr in EFI_SYSTEM_TABLE and returns the number of Unicode 
    138   characters that printed to StdErr.  If the length of the formatted Unicode 
    139   string is greater than PcdUefiLibMaxPrintBufferSize, then only the first 
     136  This function prints a formatted Unicode string to the console output device
     137  specified by StdErr in EFI_SYSTEM_TABLE and returns the number of Unicode
     138  characters that printed to StdErr.  If the length of the formatted Unicode
     139  string is greater than PcdUefiLibMaxPrintBufferSize, then only the first
    140140  PcdUefiLibMaxPrintBufferSize characters are sent to StdErr.
    141141  If Format is NULL, then ASSERT().
    … …  
    144144
    145145  @param Format   Null-terminated Unicode format string.
    146   @param ...      Variable argument list whose contents are accessed based 
     146  @param ...      Variable argument list whose contents are accessed based
    147147                  on the format string specified by Format.
    148  
     148
    149149  @return Number of Unicode characters printed to StdErr.
    150150
    … …  
    226226}
    227227
    228 /** 
    229   Prints a formatted ASCII string to the console output device specified by 
     228/**
     229  Prints a formatted ASCII string to the console output device specified by
    230230  ConOut defined in the EFI_SYSTEM_TABLE.
    231231
    232   This function prints a formatted ASCII string to the console output device 
    233   specified by ConOut in EFI_SYSTEM_TABLE and returns the number of ASCII 
    234   characters that printed to ConOut.  If the length of the formatted ASCII 
    235   string is greater than PcdUefiLibMaxPrintBufferSize, then only the first 
     232  This function prints a formatted ASCII string to the console output device
     233  specified by ConOut in EFI_SYSTEM_TABLE and returns the number of ASCII
     234  characters that printed to ConOut.  If the length of the formatted ASCII
     235  string is greater than PcdUefiLibMaxPrintBufferSize, then only the first
    236236  PcdUefiLibMaxPrintBufferSize characters are sent to ConOut.
    237237  If Format is NULL, then ASSERT().
    … …  
    239239
    240240  @param Format   Null-terminated ASCII format string.
    241   @param ...      Variable argument list whose contents are accessed based 
     241  @param ...      Variable argument list whose contents are accessed based
    242242                  on the format string specified by Format.
    243  
     243
    244244  @return Number of ASCII characters printed to ConOut.
    245245
    … …  
    265265}
    266266
    267 /** 
    268   Prints a formatted ASCII string to the console output device specified by 
     267/**
     268  Prints a formatted ASCII string to the console output device specified by
    269269  StdErr defined in the EFI_SYSTEM_TABLE.
    270270
    271   This function prints a formatted ASCII string to the console output device 
    272   specified by StdErr in EFI_SYSTEM_TABLE and returns the number of ASCII 
    273   characters that printed to StdErr.  If the length of the formatted ASCII 
    274   string is greater than PcdUefiLibMaxPrintBufferSize, then only the first 
     271  This function prints a formatted ASCII string to the console output device
     272  specified by StdErr in EFI_SYSTEM_TABLE and returns the number of ASCII
     273  characters that printed to StdErr.  If the length of the formatted ASCII
     274  string is greater than PcdUefiLibMaxPrintBufferSize, then only the first
    275275  PcdUefiLibMaxPrintBufferSize characters are sent to StdErr.
    276276  If Format is NULL, then ASSERT().
    … …  
    278278
    279279  @param Format   Null-terminated ASCII format string.
    280   @param ...      Variable argument list whose contents are accessed based 
     280  @param ...      Variable argument list whose contents are accessed based
    281281                  on the format string specified by Format.
    282  
     282
    283283  @return Number of ASCII characters printed to ConErr.
    284284
    … …  
    554554
    555555/**
    556   Prints a formatted Unicode string to a graphics console device specified by 
     556  Prints a formatted Unicode string to a graphics console device specified by
    557557  ConsoleOutputHandle defined in the EFI_SYSTEM_TABLE at the given (X,Y) coordinates.
    558558
    559   This function prints a formatted Unicode string to the graphics console device 
    560   specified by ConsoleOutputHandle in EFI_SYSTEM_TABLE and returns the number of 
    561   Unicode characters displayed, not including partial characters that may be clipped 
     559  This function prints a formatted Unicode string to the graphics console device
     560  specified by ConsoleOutputHandle in EFI_SYSTEM_TABLE and returns the number of
     561  Unicode characters displayed, not including partial characters that may be clipped
    562562  by the right edge of the display.  If the length of the formatted Unicode string is
    563   greater than PcdUefiLibMaxPrintBufferSize, then at most the first 
     563  greater than PcdUefiLibMaxPrintBufferSize, then at most the first
    564564  PcdUefiLibMaxPrintBufferSize characters are printed.The EFI_HII_FONT_PROTOCOL
    565   StringToImage() service is used to convert the string to a bitmap using the glyphs 
    566   registered with the HII database. No wrapping is performed, so any portions of the 
    567   string the fall outside the active display region will not be displayed. Please see 
     565  StringToImage() service is used to convert the string to a bitmap using the glyphs
     566  registered with the HII database. No wrapping is performed, so any portions of the
     567  string the fall outside the active display region will not be displayed. Please see
    568568  Section 27.2.6 of the UEFI Specification for a description of the supported string
    569569  format including the set of control codes supported by the StringToImage() service.
    570570
    571   If a graphics console device is not associated with the ConsoleOutputHandle 
     571  If a graphics console device is not associated with the ConsoleOutputHandle
    572572  defined in the EFI_SYSTEM_TABLE then no string is printed, and 0 is returned.
    573   If the EFI_HII_FONT_PROTOCOL is not present in the handle database, then no 
     573  If the EFI_HII_FONT_PROTOCOL is not present in the handle database, then no
    574574  string is printed, and 0 is returned.
    575575  If Format is NULL, then ASSERT().
    … …  
    584584                       in the EFI_SYSTEM_TABLE is used.
    585585  @param  BackGround   The background color of the string being printed.  This is
    586                        an optional parameter that may be NULL.  If it is NULL, 
     586                       an optional parameter that may be NULL.  If it is NULL,
    587587                       then the background color of the current ConOut device
    588588                       in the EFI_SYSTEM_TABLE is used.
    589   @param  Format       Null-terminated Unicode format string.  See Print Library 
     589  @param  Format       Null-terminated Unicode format string.  See Print Library
    590590                       for the supported format string syntax.
    591   @param  ...          Variable argument list whose contents are accessed based on 
    592                        the format string specified by Format.         
     591  @param  ...          Variable argument list whose contents are accessed based on
     592                       the format string specified by Format.
    593593
    594594  @return  The number of Unicode characters printed.
    … …  
    634634
    635635/**
    636   Prints a formatted ASCII string to a graphics console device specified by 
     636  Prints a formatted ASCII string to a graphics console device specified by
    637637  ConsoleOutputHandle defined in the EFI_SYSTEM_TABLE at the given (X,Y) coordinates.
    638638
    639   This function prints a formatted ASCII string to the graphics console device 
    640   specified by ConsoleOutputHandle in EFI_SYSTEM_TABLE and returns the number of 
    641   ASCII characters displayed, not including partial characters that may be clipped 
     639  This function prints a formatted ASCII string to the graphics console device
     640  specified by ConsoleOutputHandle in EFI_SYSTEM_TABLE and returns the number of
     641  ASCII characters displayed, not including partial characters that may be clipped
    642642  by the right edge of the display.  If the length of the formatted ASCII string is
    643   greater than PcdUefiLibMaxPrintBufferSize, then at most the first 
     643  greater than PcdUefiLibMaxPrintBufferSize, then at most the first
    644644  PcdUefiLibMaxPrintBufferSize characters are printed.The EFI_HII_FONT_PROTOCOL
    645   StringToImage() service is used to convert the string to a bitmap using the glyphs 
    646   registered with the HII database. No wrapping is performed, so any portions of the 
    647   string the fall outside the active display region will not be displayed. Please see 
     645  StringToImage() service is used to convert the string to a bitmap using the glyphs
     646  registered with the HII database. No wrapping is performed, so any portions of the
     647  string the fall outside the active display region will not be displayed. Please see
    648648  Section 27.2.6 of the UEFI Specification for a description of the supported string
    649649  format including the set of control codes supported by the StringToImage() service.
    650650
    651   If a graphics console device is not associated with the ConsoleOutputHandle 
     651  If a graphics console device is not associated with the ConsoleOutputHandle
    652652  defined in the EFI_SYSTEM_TABLE then no string is printed, and 0 is returned.
    653   If the EFI_HII_FONT_PROTOCOL is not present in the handle database, then no 
     653  If the EFI_HII_FONT_PROTOCOL is not present in the handle database, then no
    654654  string is printed, and 0 is returned.
    655655  If Format is NULL, then ASSERT().
    … …  
    663663                       in the EFI_SYSTEM_TABLE is used.
    664664  @param  BackGround   The background color of the string being printed.  This is
    665                        an optional parameter that may be NULL.  If it is NULL, 
     665                       an optional parameter that may be NULL.  If it is NULL,
    666666                       then the background color of the current ConOut device
    667667                       in the EFI_SYSTEM_TABLE is used.
    668   @param  Format       Null-terminated ASCII format string.  See Print Library 
     668  @param  Format       Null-terminated ASCII format string.  See Print Library
    669669                       for the supported format string syntax.
    670   @param  ...          Variable argument list whose contents are accessed based on 
    671                        the format string specified by Format.         
     670  @param  ...          Variable argument list whose contents are accessed based on
     671                       the format string specified by Format.
    672672
    673673  @return  The number of ASCII characters printed.
    … …  
    711711}
    712712
    713 /** 
     713/**
    714714  Appends a formatted Unicode string to a Null-terminated Unicode string
    715  
    716   This function appends a formatted Unicode string to the Null-terminated 
     715
     716  This function appends a formatted Unicode string to the Null-terminated
    717717  Unicode string specified by String.   String is optional and may be NULL.
    718   Storage for the formatted Unicode string returned is allocated using 
     718  Storage for the formatted Unicode string returned is allocated using
    719719  AllocatePool().  The pointer to the appended string is returned.  The caller
    720720  is responsible for freeing the returned string.
    721  
     721
    722722  If String is not NULL and not aligned on a 16-bit boundary, then ASSERT().
    723723  If FormatString is NULL, then ASSERT().
    724724  If FormatString is not aligned on a 16-bit boundary, then ASSERT().
    725  
     725
    726726  @param[in] String         A Null-terminated Unicode string.
    727727  @param[in] FormatString   A Null-terminated Unicode format string.
    … …  
    729729
    730730  @retval NULL    There was not enough available memory.
    731   @return         Null-terminated Unicode string is that is the formatted 
     731  @return         Null-terminated Unicode string is that is the formatted
    732732                  string appended to String.
    733733**/
    … …  
    772772}
    773773
    774 /** 
     774/**
    775775  Appends a formatted Unicode string to a Null-terminated Unicode string
    776  
    777   This function appends a formatted Unicode string to the Null-terminated 
     776
     777  This function appends a formatted Unicode string to the Null-terminated
    778778  Unicode string specified by String.   String is optional and may be NULL.
    779   Storage for the formatted Unicode string returned is allocated using 
     779  Storage for the formatted Unicode string returned is allocated using
    780780  AllocatePool().  The pointer to the appended string is returned.  The caller
    781781  is responsible for freeing the returned string.
    782  
     782
    783783  If String is not NULL and not aligned on a 16-bit boundary, then ASSERT().
    784784  If FormatString is NULL, then ASSERT().
    785785  If FormatString is not aligned on a 16-bit boundary, then ASSERT().
    786  
     786
    787787  @param[in] String         A Null-terminated Unicode string.
    788788  @param[in] FormatString   A Null-terminated Unicode format string.
    789   @param[in] ...            The variable argument list whose contents are 
    790                             accessed based on the format string specified by 
     789  @param[in] ...            The variable argument list whose contents are
     790                            accessed based on the format string specified by
    791791                            FormatString.
    792792
    793793  @retval NULL    There was not enough available memory.
    794   @return         Null-terminated Unicode string is that is the formatted 
     794  @return         Null-terminated Unicode string is that is the formatted
    795795                  string appended to String.
    796796**/

  • trunk/src/VBox/Devices/EFI/Firmware/IntelFrameworkPkg/Library/FrameworkUefiLib/UefiNotTiano.c

    r48674 r58466  
    2727  This empty function ensures that EVT_NOTIFY_SIGNAL_ALL is error
    2828  checked correctly since it is now mapped into CreateEventEx() in UEFI 2.0.
    29  
     29
    3030  @param  Event                 Event whose notification function is being invoked.
    3131  @param  Context               Pointer to the notification function's context,
    … …  
    298298
    299299  //
    300   // EFI Specification extension on Media Device Path. MEDIA_FW_VOL_FILEPATH_DEVICE_PATH is adopted by UEFI later and added in UEFI2.10. 
     300  // EFI Specification extension on Media Device Path. MEDIA_FW_VOL_FILEPATH_DEVICE_PATH is adopted by UEFI later and added in UEFI2.10.
    301301  // In EdkCompatibility Package, we only support MEDIA_FW_VOL_FILEPATH_DEVICE_PATH that complies with
    302302  // EFI 1.10 and UEFI 2.10.
    … …  
    336336
    337337  //
    338   // EFI Specification extension on Media Device Path. MEDIA_FW_VOL_FILEPATH_DEVICE_PATH is adopted by UEFI later and added in UEFI2.10. 
     338  // EFI Specification extension on Media Device Path. MEDIA_FW_VOL_FILEPATH_DEVICE_PATH is adopted by UEFI later and added in UEFI2.10.
    339339  // In EdkCompatibility Package, we only support MEDIA_FW_VOL_FILEPATH_DEVICE_PATH that complies with
    340340  // EFI 1.10 and UEFI 2.10.
    … …  
    343343  FvDevicePathNode->Header.SubType  = MEDIA_PIWG_FW_FILE_DP;
    344344  SetDevicePathNodeLength (&FvDevicePathNode->Header, sizeof (MEDIA_FW_VOL_FILEPATH_DEVICE_PATH));
    345  
     345
    346346  CopyGuid (&FvDevicePathNode->FvFileName, NameGuid);
    347347}

  • trunk/src/VBox/Devices/EFI/Firmware/IntelFrameworkPkg/Library/PeiHobLibFramework/HobLib.c

    r58459 r58466  
    44 HOB Library implementation that uses PEI Services to retrieve the HOB List.
    55 This library instance uses EFI_HOB_TYPE_CV defined in Intel framework HOB specification v0.9
    6  to implement HobLib BuildCvHob() API. 
     6 to implement HobLib BuildCvHob() API.
    77
    88Copyright (c) 2007 - 2014, Intel Corporation. All rights reserved.<BR>
    … …  
    3030
    3131  This function returns the pointer to first HOB in the list.
    32   For PEI phase, the PEI service GetHobList() can be used to retrieve the pointer 
     32  For PEI phase, the PEI service GetHobList() can be used to retrieve the pointer
    3333  to the HOB list.  For the DXE phase, the HOB list pointer can be retrieved through
    3434  the EFI System Table by looking up theHOB list GUID in the System Configuration Table.
    35   Since the System Configuration Table does not exist that the time the DXE Core is 
    36   launched, the DXE Core uses a global variable from the DXE Core Entry Point Library 
     35  Since the System Configuration Table does not exist that the time the DXE Core is
     36  launched, the DXE Core uses a global variable from the DXE Core Entry Point Library
    3737  to manage the pointer to the HOB list.
    38  
     38
    3939  If the pointer to the HOB list is NULL, then ASSERT().
    40  
     40
    4141  @return The pointer to the HOB list.
    4242
    … …  
    6161  Returns the next instance of a HOB type from the starting HOB.
    6262
    63   This function searches the first instance of a HOB type from the starting HOB pointer. 
     63  This function searches the first instance of a HOB type from the starting HOB pointer.
    6464  If there does not exist such HOB type from the starting HOB pointer, it will return NULL.
    6565  In contrast with macro GET_NEXT_HOB(), this function does not skip the starting HOB pointer
    6666  unconditionally: it returns HobStart back if HobStart itself meets the requirement;
    6767  caller is required to use GET_NEXT_HOB() if it wishes to skip current HobStart.
    68  
     68
    6969  If HobStart is NULL, then ASSERT().
    7070
    … …  
    8585
    8686  ASSERT (HobStart != NULL);
    87    
     87
    8888  Hob.Raw = (UINT8 *) HobStart;
    8989  //
    … …  
    102102  Returns the first instance of a HOB type among the whole HOB list.
    103103
    104   This function searches the first instance of a HOB type among the whole HOB list. 
    105   If there does not exist such HOB type in the HOB list, it will return NULL. 
    106  
     104  This function searches the first instance of a HOB type among the whole HOB list.
     105  If there does not exist such HOB type in the HOB list, it will return NULL.
     106
    107107  If the pointer to the HOB list is NULL, then ASSERT().
    108108
    … …  
    126126/**
    127127  Returns the next instance of the matched GUID HOB from the starting HOB.
    128  
    129   This function searches the first instance of a HOB from the starting HOB pointer. 
    130   Such HOB should satisfy two conditions: 
    131   its HOB type is EFI_HOB_TYPE_GUID_EXTENSION and its GUID Name equals to the input Guid. 
    132   If there does not exist such HOB from the starting HOB pointer, it will return NULL. 
     128
     129  This function searches the first instance of a HOB from the starting HOB pointer.
     130  Such HOB should satisfy two conditions:
     131  its HOB type is EFI_HOB_TYPE_GUID_EXTENSION and its GUID Name equals to the input Guid.
     132  If there does not exist such HOB from the starting HOB pointer, it will return NULL.
    133133  Caller is required to apply GET_GUID_HOB_DATA () and GET_GUID_HOB_DATA_SIZE ()
    134134  to extract the data section and its size info respectively.
    … …  
    136136  unconditionally: it returns HobStart back if HobStart itself meets the requirement;
    137137  caller is required to use GET_NEXT_HOB() if it wishes to skip current HobStart.
    138  
     138
    139139  If Guid is NULL, then ASSERT().
    140140  If HobStart is NULL, then ASSERT().
    … …  
    167167/**
    168168  Returns the first instance of the matched GUID HOB among the whole HOB list.
    169  
    170   This function searches the first instance of a HOB among the whole HOB list. 
     169
     170  This function searches the first instance of a HOB among the whole HOB list.
    171171  Such HOB should satisfy two conditions:
    172172  its HOB type is EFI_HOB_TYPE_GUID_EXTENSION and its GUID Name equals to the input Guid.
    … …  
    174174  Caller is required to apply GET_GUID_HOB_DATA () and GET_GUID_HOB_DATA_SIZE ()
    175175  to extract the data section and its size info respectively.
    176  
     176
    177177  If the pointer to the HOB list is NULL, then ASSERT().
    178178  If Guid is NULL, then ASSERT().
    … …  
    198198  Get the system boot mode from the HOB list.
    199199
    200   This function returns the system boot mode information from the 
     200  This function returns the system boot mode information from the
    201201  PHIT HOB in HOB list.
    202202
    203203  If the pointer to the HOB list is NULL, then ASSERT().
    204  
     204
    205205  @param  VOID
    206206
    … …  
    262262  It can only be invoked during PEI phase;
    263263  for DXE phase, it will ASSERT() since PEI HOB is read-only for DXE phase.
    264  
     264
    265265  If ModuleName is NULL, then ASSERT().
    266266  If there is no additional space for HOB creation, then ASSERT().
    … …  
    300300  //
    301301  ZeroMem (Hob->MemoryAllocationHeader.Reserved, sizeof (Hob->MemoryAllocationHeader.Reserved));
    302  
     302
    303303  CopyGuid (&Hob->ModuleName, ModuleName);
    304304  Hob->EntryPoint = EntryPoint;
    … …  
    311311  It can only be invoked during PEI phase;
    312312  for DXE phase, it will ASSERT() since PEI HOB is read-only for DXE phase.
    313  
     313
    314314  If there is no additional space for HOB creation, then ASSERT().
    315315
    … …  
    352352  It can only be invoked during PEI phase;
    353353  for DXE phase, it will ASSERT() since PEI HOB is read-only for DXE phase.
    354  
     354
    355355  If there is no additional space for HOB creation, then ASSERT().
    356356
    … …  
    385385
    386386/**
    387   Builds a customized HOB tagged with a GUID for identification and returns 
     387  Builds a customized HOB tagged with a GUID for identification and returns
    388388  the start address of GUID HOB data.
    389389
    390   This function builds a customized HOB tagged with a GUID for identification 
    391   and returns the start address of GUID HOB data so that caller can fill the customized data. 
     390  This function builds a customized HOB tagged with a GUID for identification
     391  and returns the start address of GUID HOB data so that caller can fill the customized data.
    392392  The HOB Header and Name field is already stripped.
    393393  It can only be invoked during PEI phase;
    394394  for DXE phase, it will ASSERT() since PEI HOB is read-only for DXE phase.
    395  
     395
    396396  If Guid is NULL, then ASSERT().
    397397  If there is no additional space for HOB creation, then ASSERT().
    … …  
    418418  //
    419419  ASSERT (Guid != NULL);
    420  
     420
    421421  //
    422422  // Make sure that data length is not too long.
    … …  
    433433
    434434/**
    435   Builds a customized HOB tagged with a GUID for identification, copies the input data to the HOB 
     435  Builds a customized HOB tagged with a GUID for identification, copies the input data to the HOB
    436436  data field, and returns the start address of the GUID HOB data.
    437437
    438438  This function builds a customized HOB tagged with a GUID for identification and copies the input
    439   data to the HOB data field and returns the start address of the GUID HOB data.  It can only be 
    440   invoked during PEI phase; for DXE phase, it will ASSERT() since PEI HOB is read-only for DXE phase. 
     439  data to the HOB data field and returns the start address of the GUID HOB data.  It can only be
     440  invoked during PEI phase; for DXE phase, it will ASSERT() since PEI HOB is read-only for DXE phase.
    441441  The HOB Header and Name field is already stripped.
    442442  It can only be invoked during PEI phase;
    443443  for DXE phase, it will ASSERT() since PEI HOB is read-only for DXE phase.
    444  
     444
    445445  If Guid is NULL, then ASSERT().
    446446  If Data is NULL and DataLength > 0, then ASSERT().
    … …  
    482482  It can only be invoked during PEI phase;
    483483  for DXE phase, it will ASSERT() since PEI HOB is read-only for DXE phase.
    484  
     484
    485485  If there is no additional space for HOB creation, then ASSERT().
    486486
    … …  
    513513  It can only be invoked during PEI phase;
    514514  for DXE phase, it will ASSERT() since PEI HOB is read-only for DXE phase.
    515  
     515
    516516  If there is no additional space for HOB creation, then ASSERT().
    517517
    … …  
    520520  @param  FvName        The name of the Firmware Volume.
    521521  @param  FileName      The name of the file.
    522  
     522
    523523**/
    524524VOID
    … …  
    550550  It can only be invoked during PEI phase;
    551551  for DXE phase, it will ASSERT() since PEI HOB is read-only for DXE phase.
    552  
     552
    553553  If the platform does not support Capsule Volume HOBs, then ASSERT().
    554554  If there is no additional space for HOB creation, then ASSERT().
    … …  
    582582  It can only be invoked during PEI phase;
    583583  for DXE phase, it will ASSERT() since PEI HOB is read-only for DXE phase.
    584  
     584
    585585  If there is no additional space for HOB creation, then ASSERT().
    586586
    … …  
    609609  // Zero the reserved space to match HOB spec
    610610  //
    611   ZeroMem (Hob->Reserved, sizeof (Hob->Reserved)); 
     611  ZeroMem (Hob->Reserved, sizeof (Hob->Reserved));
    612612}
    613613
    … …  
    618618  It can only be invoked during PEI phase;
    619619  for DXE phase, it will ASSERT() since PEI HOB is read-only for DXE phase.
    620  
     620
    621621  If there is no additional space for HOB creation, then ASSERT().
    622622
    … …  
    659659  It can only be invoked during PEI phase;
    660660  for DXE phase, it will ASSERT() since PEI HOB is read-only for DXE phase.
    661  
     661
    662662  If there is no additional space for HOB creation, then ASSERT().
    663663
    … …  
    702702  It can only be invoked during PEI phase;
    703703  for DXE phase, it will ASSERT() since PEI HOB is read-only for DXE phase.
    704  
     704
    705705  If there is no additional space for HOB creation, then ASSERT().
    706706
    … …  
    722722  ASSERT (((BaseAddress & (EFI_PAGE_SIZE - 1)) == 0) &&
    723723          ((Length & (EFI_PAGE_SIZE - 1)) == 0));
    724  
     724
    725725  Hob = InternalPeiCreateHob (EFI_HOB_TYPE_MEMORY_ALLOCATION, (UINT16) sizeof (EFI_HOB_MEMORY_ALLOCATION));
    726726  if (Hob == NULL) {
    727727    return;
    728728  }
    729  
     729
    730730  ZeroMem (&(Hob->AllocDescriptor.Name), sizeof (EFI_GUID));
    731731  Hob->AllocDescriptor.MemoryBaseAddress = BaseAddress;

  • trunk/src/VBox/Devices/EFI/Firmware/IntelFrameworkPkg/Library/PeiHobLibFramework/PeiHobLibFramework.inf

    r58459 r58466  
    44# HOB Library implementation that uses PEI Services to retrieve the HOB List.
    55# This library instance uses EFI_HOB_TYPE_CV defined in Intel framework HOB specification v0.9
    6 # to implement HobLib BuildCvHob() API. 
     6# to implement HobLib BuildCvHob() API.
    77#
    88# Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
    … …  
    5555#   RESOURCE_DESCRIPTOR   ## SOMETIMES_PRODUCES
    5656#   FIRMWARE_VOLUME       ## SOMETIMES_PRODUCES
    57 #   
     57#
    5858

  • trunk/src/VBox/Devices/EFI/Firmware/IntelFrameworkPkg/Library/PeiSmbusLibSmbusPpi/InternalSmbusLib.h

    r48674 r58466  
    33
    44Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>
    5 This program and the accompanying materials                         
    6 are licensed and made available under the terms and conditions of the BSD License         
    7 which accompanies this distribution.  The full text of the license may be found at       
    8 http://opensource.org/licenses/bsd-license.php                                           
    9                                                                                          
    10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     
    11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             
     5This program and the accompanying materials
     6are licensed and made available under the terms and conditions of the BSD License
     7which accompanies this distribution.  The full text of the license may be found at
     8http://opensource.org/licenses/bsd-license.php
     9
     10THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
     11WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
    1212
    1313**/
    … …  
    4747
    4848/**
    49   Executes an SMBus operation to an SMBus controller. 
     49  Executes an SMBus operation to an SMBus controller.
    5050
    5151  This function provides a standard way to execute Smbus script

  • trunk/src/VBox/Devices/EFI/Firmware/IntelFrameworkPkg/Library/PeiSmbusLibSmbusPpi/PeiSmbusLib.c

    r48674 r58466  
    33
    44Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>
    5 This program and the accompanying materials                         
    6 are licensed and made available under the terms and conditions of the BSD License         
    7 which accompanies this distribution.  The full text of the license may be found at       
    8 http://opensource.org/licenses/bsd-license.php                                           
    9                                                                                          
    10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     
    11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             
     5This program and the accompanying materials
     6are licensed and made available under the terms and conditions of the BSD License
     7which accompanies this distribution.  The full text of the license may be found at
     8http://opensource.org/licenses/bsd-license.php
     9
     10THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
     11WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
    1212
    1313**/
    … …  
    2020  This internal function retrieves Smbus PPI from PPI database.
    2121  If gEfiPeiSmbusPpiGuid can not be located, then ASSERT()
    22  
     22
    2323  @return The pointer to Smbus PPI.
    2424
    … …  
    2727InternalGetSmbusPpi (
    2828  VOID
    29   ) 
     29  )
    3030{
    3131  EFI_STATUS            Status;
    … …  
    4040
    4141/**
    42   Executes an SMBus operation to an SMBus controller. 
     42  Executes an SMBus operation to an SMBus controller.
    4343
    4444  This function provides a standard way to execute Smbus script
    … …  
    8484                             SMBUS_LIB_COMMAND (SmBusAddress),
    8585                             SmbusOperation,
    86                              SMBUS_LIB_PEC (SmBusAddress), 
     86                             SMBUS_LIB_PEC (SmBusAddress),
    8787                             &Length,
    8888                             Buffer

  • trunk/src/VBox/Devices/EFI/Firmware/IntelFrameworkPkg/Library/PeiSmbusLibSmbusPpi/PeiSmbusLibSmbusPpi.inf

    r58459 r58466  
    2121  MODULE_TYPE                    = PEIM
    2222  VERSION_STRING                 = 1.0
    23   LIBRARY_CLASS                  = SmbusLib|PEIM 
     23  LIBRARY_CLASS                  = SmbusLib|PEIM
    2424
    2525

  • trunk/src/VBox/Devices/EFI/Firmware/IntelFrameworkPkg/Library/PeiSmbusLibSmbusPpi/SmbusLib.c

    r48674 r58466  
    33
    44Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>
    5 This program and the accompanying materials                         
    6 are licensed and made available under the terms and conditions of the BSD License         
    7 which accompanies this distribution.  The full text of the license may be found at       
    8 http://opensource.org/licenses/bsd-license.php                                           
    9                                                                                          
    10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     
    11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             
     5This program and the accompanying materials
     6are licensed and made available under the terms and conditions of the BSD License
     7which accompanies this distribution.  The full text of the license may be found at
     8http://opensource.org/licenses/bsd-license.php
     9
     10THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
     11WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
    1212
    1313
    … …  
    190190
    191191  InternalSmBusExec (EfiSmbusReadByte, SmBusAddress, 1, &Byte, Status);
    192  
     192
    193193  return Byte;
    194194}
    … …  
    229229  Byte = Value;
    230230  InternalSmBusExec (EfiSmbusWriteByte, SmBusAddress, 1, &Byte, Status);
    231  
     231
    232232  return Value;
    233233}
    … …  
    242242  If Length in SmBusAddress is not zero, then ASSERT().
    243243  If any reserved bits of SmBusAddress are set, then ASSERT().
    244  
     244
    245245  @param  SmBusAddress    Address that encodes the SMBUS Slave Address,
    246246                          SMBUS Command, SMBUS Data Length, and PEC.
    … …  
    264264
    265265  InternalSmBusExec (EfiSmbusReadWord, SmBusAddress, 2, &Word, Status);
    266  
     266
    267267  return Word;
    268268}
    … …  
    339339
    340340  InternalSmBusExec (EfiSmbusProcessCall, SmBusAddress, 2, &Value, Status);
    341  
     341
    342342  return Value;
    343343}
    … …  
    388388  Bytes are written to the SMBUS from Buffer.
    389389  The number of bytes written is returned, and will never return a value larger than 32-bytes.
    390   If Status is not NULL, then the status of the executed command is returned in Status. 
     390  If Status is not NULL, then the status of the executed command is returned in Status.
    391391  If Length in SmBusAddress is zero or greater than 32, then ASSERT().
    392392  If Buffer is NULL, then ASSERT().
Note: See TracChangeset for help on using the changeset viewer.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette