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:
7 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/VBox/Devices/EFI/Firmware

  • trunk/src/VBox/Devices/EFI/Firmware/MdePkg/Library/UefiLib/Console.c

    r58459 r58466  
    33
    44  Copyright (c) 2006 - 2013, 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**/
     
    3232  {(CHAR16)0x1FFF,  1},
    3333  /*
    34    * Merge the blocks and replace them with the above entry as they fall to 
     34   * Merge the blocks and replace them with the above entry as they fall to
    3535   * the same category and they are all narrow glyph. This will reduce search
    3636   * time and table size. The merge will omit the reserved code.
     
    7979  {(CHAR16)0x2FFF,  1},
    8080  /*
    81    * Merge the blocks and replace them with the above entry as they fall to 
     81   * Merge the blocks and replace them with the above entry as they fall to
    8282   * the same category and they are all narrow glyph. This will reduce search
    8383   * time and table size. The merge will omit the reserved code.
     
    111111  {(CHAR16)0x33FF,  2},
    112112  /*
    113    * Merge the blocks and replace them with the above entry as they fall to 
     113   * Merge the blocks and replace them with the above entry as they fall to
    114114   * the same category and they are all wide glyph. This will reduce search
    115115   * time and table size. The merge will omit the reserved code.
     
    134134  {(CHAR16)0x9FFF,  2},
    135135  /*
    136    * Merge the blocks and replace them with the above entry as they fall to 
     136   * Merge the blocks and replace them with the above entry as they fall to
    137137   * the same category and they are all wide glyph. This will reduce search
    138138   * time and table size. The merge will omit the reserved code.
     
    140140   * Remove the above item if below is un-commented.
    141141   *
    142   {(CHAR16)0x4DFF,  0},       // Reserved. 0x3400-0x4DBF as CJK unified ideographs 
     142  {(CHAR16)0x4DFF,  0},       // Reserved. 0x3400-0x4DBF as CJK unified ideographs
    143143                      // extension A in ver3.0. 0x3400-0x4DFF
    144144  {(CHAR16)0x9FFF,  2},       // CJK unified ideographs. 0x4E00-0x9FFF
     
    156156  {(CHAR16)0xD7FF,  2},
    157157  /*
    158    * Merge the blocks and replace them with the above entry as they fall to 
     158   * Merge the blocks and replace them with the above entry as they fall to
    159159   * the same category and they are all wide glyph. This will reduce search
    160160   * time and table size. The merge will omit the reserved code.
     
    252252  Computes the display length of a Null-terminated Unicode String.
    253253
    254   This function computes and returns the display length of the Null-terminated 
    255   Unicode string specified by String.  If String is NULL then 0 is returned. If 
    256   any of the widths of the Unicode characters in String can not be determined, 
    257   then 0 is returned. The display width of String can be computed by summing the 
    258   display widths of each Unicode character in String.  Unicode characters that 
    259   are narrow glyphs have a width of 1, and Unicode characters that are width glyphs 
     254  This function computes and returns the display length of the Null-terminated
     255  Unicode string specified by String.  If String is NULL then 0 is returned. If
     256  any of the widths of the Unicode characters in String can not be determined,
     257  then 0 is returned. The display width of String can be computed by summing the
     258  display widths of each Unicode character in String.  Unicode characters that
     259  are narrow glyphs have a width of 1, and Unicode characters that are width glyphs
    260260  have a width of 2.  If String is not aligned on a 16-bit boundary, then ASSERT().
    261261
     
    263263
    264264  @return The display length of the Null-terminated Unicode string specified by String.
    265  
     265
    266266**/
    267267UINTN
     
    293293
    294294/**
    295   Count the storage space of a Unicode string. 
     295  Count the storage space of a Unicode string.
    296296
    297297  This function handles the Unicode string with NARROW_CHAR
     
    304304  @param LimitLen        Whether need to limit the string length.
    305305  @param MaxWidth        The max length this function supported.
    306   @param Offset          The max index of the string can be show out. 
     306  @param Offset          The max index of the string can be show out.
    307307
    308308  @return Storage space for the input string.
     
    376376
    377377/**
    378   Draws a dialog box to the console output device specified by 
     378  Draws a dialog box to the console output device specified by
    379379  ConOut defined in the EFI_SYSTEM_TABLE and waits for a keystroke
    380   from the console input device specified by ConIn defined in the 
     380  from the console input device specified by ConIn defined in the
    381381  EFI_SYSTEM_TABLE.
    382382
     
    385385
    386386  @param[in]   Attribute  Specifies the foreground and background color of the popup.
    387   @param[out]  Key        A pointer to the EFI_KEY value of the key that was 
     387  @param[out]  Key        A pointer to the EFI_KEY value of the key that was
    388388                          pressed.  This is an optional parameter that may be NULL.
    389389                          If it is NULL then no wait for a keypress will be performed.
    390390  @param[in]  ...         The variable argument list that contains pointers to Null-
    391                           terminated Unicode strings to display in the dialog box. 
     391                          terminated Unicode strings to display in the dialog box.
    392392                          The variable argument list is terminated by a NULL.
    393393
     
    396396EFIAPI
    397397CreatePopUp (
    398   IN  UINTN          Attribute,               
     398  IN  UINTN          Attribute,
    399399  OUT EFI_INPUT_KEY  *Key,      OPTIONAL
    400400  ...
     
    418418
    419419  //
    420   // Determine the length of the longest line in the popup and the the total 
     420  // Determine the length of the longest line in the popup and the the total
    421421  // number of lines in the popup
    422422  //
     
    444444  //
    445445  ConOut = gST->ConOut;
    446  
     446
    447447  //
    448448  // Save the current console cursor position and attributes
     
    484484
    485485  //
    486   // Draw top of popup box   
     486  // Draw top of popup box
    487487  //
    488488  SetMem16 (Line, (MaxLength + 2) * 2, BOXDRAW_HORIZONTAL);
  • trunk/src/VBox/Devices/EFI/Firmware/MdePkg/Library/UefiLib/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.
     
    119119  DriverBinding->ImageHandle         = ImageHandle;
    120120  DriverBinding->DriverBindingHandle = DriverBindingHandle;
    121  
     121
    122122  if (DriverDiagnostics == NULL || FeaturePcdGet(PcdDriverDiagnosticsDisable)) {
    123123    if (DriverConfiguration == NULL) {
     
    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/MdePkg/Library/UefiLib/UefiLib.c

    r58459 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
     
    2121
    2222/**
    23   Empty constructor function that is required to resolve dependencies between 
     23  Empty constructor function that is required to resolve dependencies between
    2424  libraries.
    25  
     25
    2626    ** DO NOT REMOVE **
    27  
     27
    2828  @param  ImageHandle   The firmware allocated handle for the EFI image.
    2929  @param  SystemTable   A pointer to the EFI System Table.
    30  
     30
    3131  @retval EFI_SUCCESS   The constructor executed correctly.
    3232
     
    7070  Retrieves a pointer to the system configuration table from the EFI System Table
    7171  based on a specified GUID.
    72  
     72
    7373  This function searches the list of configuration tables stored in the EFI System Table
    7474  for a table with a GUID that matches TableGuid.  If a match is found, then a pointer to
     
    119119  then the notification function is still executed one time. In addition, every time a protocol
    120120  of type ProtocolGuid instance is installed or reinstalled, the notification function is also
    121   executed. This function returns the notification event that was created. 
     121  executed. This function returns the notification event that was created.
    122122  If ProtocolGuid is NULL, then ASSERT().
    123123  If NotifyTpl is not a legal TPL value, then ASSERT().
     
    132132  @param  Registration    A pointer to a memory location to receive the registration value.
    133133                          This value is passed to LocateHandle() to obtain new handles that
    134                           have been added that support the ProtocolGuid-specified protocol. 
     134                          have been added that support the ProtocolGuid-specified protocol.
    135135
    136136  @return The notification event that was created.
     
    193193  This function creates an event using NotifyTpl, NoifyFunction, and NotifyContext.
    194194  This event is signaled with EfiNamedEventSignal(). This provides the ability for one or more
    195   listeners on the same event named by the GUID specified by Name. 
     195  listeners on the same event named by the GUID specified by Name.
    196196  If Name is NULL, then ASSERT().
    197197  If NotifyTpl is not a legal TPL value, then ASSERT().
     
    201201  @param  NotifyTpl             Supplies the task priority level of the event notifications.
    202202  @param  NotifyFunction        Supplies the function to notify when the event is signaled.
    203   @param  NotifyContext         The context parameter to pass to NotifyFunction. 
     203  @param  NotifyContext         The context parameter to pass to NotifyFunction.
    204204  @param  Registration          A pointer to a memory location to receive the registration value.
    205205
     
    225225  ASSERT (NotifyFunction != NULL);
    226226  ASSERT (NotifyTpl <= TPL_HIGH_LEVEL);
    227  
     227
    228228  //
    229229  // Create event
     
    305305}
    306306
    307 /** 
     307/**
    308308  Returns the current TPL.
    309309
    310   This function returns the current TPL.  There is no EFI service to directly 
    311   retrieve the current TPL. Instead, the RaiseTPL() function is used to raise 
    312   the TPL to TPL_HIGH_LEVEL.  This will return the current TPL.  The TPL level 
    313   can then immediately be restored back to the current TPL level with a call 
     310  This function returns the current TPL.  There is no EFI service to directly
     311  retrieve the current TPL. Instead, the RaiseTPL() function is used to raise
     312  the TPL to TPL_HIGH_LEVEL.  This will return the current TPL.  The TPL level
     313  can then immediately be restored back to the current TPL level with a call
    314314  to RestoreTPL().
    315315
     
    335335  Initializes a basic mutual exclusion lock.
    336336
    337   This function initializes a basic mutual exclusion lock to the released state 
    338   and returns the lock.  Each lock provides mutual exclusion access at its task 
     337  This function initializes a basic mutual exclusion lock to the released state
     338  and returns the lock.  Each lock provides mutual exclusion access at its task
    339339  priority level.  Since there is no preemption or multiprocessor support in EFI,
    340340  acquiring the lock only consists of raising to the locks TPL.
     
    367367  Acquires ownership of a lock.
    368368
    369   This function raises the system's current task priority level to the task 
    370   priority level of the mutual exclusion lock.  Then, it places the lock in the 
     369  This function raises the system's current task priority level to the task
     370  priority level of the mutual exclusion lock.  Then, it places the lock in the
    371371  acquired state.
    372372  If Lock is NULL, then ASSERT().
     
    433433  Releases ownership of a lock.
    434434
    435   This function transitions a mutual exclusion lock from the acquired state to 
    436   the released state, and restores the system's task priority level to its 
     435  This function transitions a mutual exclusion lock from the acquired state to
     436  the released state, and restores the system's task priority level to its
    437437  previous level.
    438438  If Lock is NULL, then ASSERT().
     
    468468  is performed by evaluating if the the protocol specified by ProtocolGuid is
    469469  present on ControllerHandle and is was opened by DriverBindingHandle with an
    470   attribute of EFI_OPEN_PROTOCOL_BY_DRIVER. 
     470  attribute of EFI_OPEN_PROTOCOL_BY_DRIVER.
    471471  If ProtocolGuid is NULL, then ASSERT().
    472472
     
    531531  If ProtocolGuid is NULL, then ASSERT().
    532532
    533   @param  ControllerHandle     A handle for a (parent) controller to test. 
     533  @param  ControllerHandle     A handle for a (parent) controller to test.
    534534  @param  ChildHandle          A child handle to test.
    535535  @param  ProtocolGuid         Supplies the protocol that the child controller
    536                                opens on its parent controller. 
     536                               opens on its parent controller.
    537537
    538538  @retval EFI_SUCCESS          ChildHandle is a child of the ControllerHandle.
     
    593593  is returned in UnicodeString.
    594594
    595   @param  Language                A pointer to the ISO 639-2 language code for the 
     595  @param  Language                A pointer to the ISO 639-2 language code for the
    596596                                  Unicode string to look up and return.
    597   @param  SupportedLanguages      A pointer to the set of ISO 639-2 language codes 
    598                                   that the Unicode string table supports.  Language 
     597  @param  SupportedLanguages      A pointer to the set of ISO 639-2 language codes
     598                                  that the Unicode string table supports.  Language
    599599                                  must be a member of this set.
    600600  @param  UnicodeStringTable      A pointer to the table of Unicode strings.
     
    602602                                  that matches the language specified by Language.
    603603
    604   @retval EFI_SUCCESS             The Unicode string that matches the language 
     604  @retval EFI_SUCCESS             The Unicode string that matches the language
    605605                                  specified by Language was found
    606                                   in the table of Unicode strings UnicodeStringTable, 
     606                                  in the table of Unicode strings UnicodeStringTable,
    607607                                  and it was returned in UnicodeString.
    608608  @retval EFI_INVALID_PARAMETER   Language is NULL.
     
    610610  @retval EFI_UNSUPPORTED         SupportedLanguages is NULL.
    611611  @retval EFI_UNSUPPORTED         UnicodeStringTable is NULL.
    612   @retval EFI_UNSUPPORTED         The language specified by Language is not a 
     612  @retval EFI_UNSUPPORTED         The language specified by Language is not a
    613613                                  member of SupportedLanguages.
    614   @retval EFI_UNSUPPORTED         The language specified by Language is not 
     614  @retval EFI_UNSUPPORTED         The language specified by Language is not
    615615                                  supported by UnicodeStringTable.
    616616
     
    685685                               not assumed to be Null-terminated, and only the first three
    686686                               characters are used. If Iso639Language is FALSE, then this ASCII
    687                                string must be Null-terminated. 
     687                               string must be Null-terminated.
    688688  @param  SupportedLanguages   A pointer to a Null-terminated ASCII string that contains a
    689689                               set of ISO 639-2 or RFC 4646 language codes that the Unicode
     
    705705                                  was found in the table of Unicode strings UnicodeStringTable, and
    706706                                  it was returned in UnicodeString.
    707   @retval  EFI_INVALID_PARAMETER  Language is NULL. 
    708   @retval  EFI_INVALID_PARAMETER  UnicodeString is NULL. 
    709   @retval  EFI_UNSUPPORTED        SupportedLanguages is NULL. 
    710   @retval  EFI_UNSUPPORTED        UnicodeStringTable is NULL. 
    711   @retval  EFI_UNSUPPORTED        The language specified by Language is not a member of SupportedLanguages. 
     707  @retval  EFI_INVALID_PARAMETER  Language is NULL.
     708  @retval  EFI_INVALID_PARAMETER  UnicodeString is NULL.
     709  @retval  EFI_UNSUPPORTED        SupportedLanguages is NULL.
     710  @retval  EFI_UNSUPPORTED        UnicodeStringTable is NULL.
     711  @retval  EFI_UNSUPPORTED        The language specified by Language is not a member of SupportedLanguages.
    712712  @retval  EFI_UNSUPPORTED        The language specified by Language is not supported by UnicodeStringTable.
    713713
     
    795795  This function adds a Unicode string to UnicodeStringTable.
    796796
    797   If Language is a member of SupportedLanguages then UnicodeString is added to 
    798   UnicodeStringTable.  New buffers are allocated for both Language and 
    799   UnicodeString.  The contents of Language and UnicodeString are copied into 
    800   these new buffers.  These buffers are automatically freed when 
     797  If Language is a member of SupportedLanguages then UnicodeString is added to
     798  UnicodeStringTable.  New buffers are allocated for both Language and
     799  UnicodeString.  The contents of Language and UnicodeString are copied into
     800  these new buffers.  These buffers are automatically freed when
    801801  FreeUnicodeStringTable() is called.
    802802
    803   @param  Language                A pointer to the ISO 639-2 language code for the Unicode 
     803  @param  Language                A pointer to the ISO 639-2 language code for the Unicode
    804804                                  string to add.
    805805  @param  SupportedLanguages      A pointer to the set of ISO 639-2 language codes
     
    809809  @param  UnicodeString           A pointer to the Unicode string to add.
    810810
    811   @retval EFI_SUCCESS             The Unicode string that matches the language 
    812                                   specified by Language was found in the table of 
    813                                   Unicode strings UnicodeStringTable, and it was 
     811  @retval EFI_SUCCESS             The Unicode string that matches the language
     812                                  specified by Language was found in the table of
     813                                  Unicode strings UnicodeStringTable, and it was
    814814                                  returned in UnicodeString.
    815815  @retval EFI_INVALID_PARAMETER   Language is NULL.
     
    817817  @retval EFI_INVALID_PARAMETER   UnicodeString is an empty string.
    818818  @retval EFI_UNSUPPORTED         SupportedLanguages is NULL.
    819   @retval EFI_ALREADY_STARTED     A Unicode string with language Language is 
     819  @retval EFI_ALREADY_STARTED     A Unicode string with language Language is
    820820                                  already present in UnicodeStringTable.
    821   @retval EFI_OUT_OF_RESOURCES    There is not enough memory to add another 
     821  @retval EFI_OUT_OF_RESOURCES    There is not enough memory to add another
    822822                                  Unicode string to UnicodeStringTable.
    823   @retval EFI_UNSUPPORTED         The language specified by Language is not a 
     823  @retval EFI_UNSUPPORTED         The language specified by Language is not a
    824824                                  member of SupportedLanguages.
    825825
     
    984984  @param  UnicodeStringTable  A pointer to the table of Unicode strings. Type EFI_UNICODE_STRING_TABLE
    985985                              is defined in "Related Definitions".
    986   @param  UnicodeString       A pointer to the Unicode string to add. 
     986  @param  UnicodeString       A pointer to the Unicode string to add.
    987987  @param  Iso639Language      Specifies the supported language code format. If it is TRUE,
    988988                              then Language and SupportedLanguages follow ISO 639-2 language code format.
     
    991991  @retval EFI_SUCCESS            The Unicode string that matches the language specified by
    992992                                 Language was found in the table of Unicode strings UnicodeStringTable,
    993                                  and it was returned in UnicodeString. 
    994   @retval EFI_INVALID_PARAMETER  Language is NULL. 
    995   @retval EFI_INVALID_PARAMETER  UnicodeString is NULL. 
    996   @retval EFI_INVALID_PARAMETER  UnicodeString is an empty string. 
    997   @retval EFI_UNSUPPORTED        SupportedLanguages is NULL. 
     993                                 and it was returned in UnicodeString.
     994  @retval EFI_INVALID_PARAMETER  Language is NULL.
     995  @retval EFI_INVALID_PARAMETER  UnicodeString is NULL.
     996  @retval EFI_INVALID_PARAMETER  UnicodeString is an empty string.
     997  @retval EFI_UNSUPPORTED        SupportedLanguages is NULL.
    998998  @retval EFI_ALREADY_STARTED    A Unicode string with language Language is already present in
    999                                  UnicodeStringTable. 
    1000   @retval EFI_OUT_OF_RESOURCES   There is not enough memory to add another Unicode string UnicodeStringTable. 
     999                                 UnicodeStringTable.
     1000  @retval EFI_OUT_OF_RESOURCES   There is not enough memory to add another Unicode string UnicodeStringTable.
    10011001  @retval EFI_UNSUPPORTED        The language specified by Language is not a member of SupportedLanguages.
    10021002
     
    10821082        for (Index = 0; LanguageString[Index] != 0 && LanguageString[Index] != ';'; Index++);
    10831083
    1084         if (AsciiStrnCmp (Language, LanguageString, Index) == 0) { 
     1084        if (AsciiStrnCmp (Language, LanguageString, Index) == 0) {
    10851085          return EFI_ALREADY_STARTED;
    10861086        }
     
    11641164
    11651165  If UnicodeStringTable is NULL, then EFI_SUCCESS is returned.
    1166   Otherwise, each language code, and each Unicode string in the Unicode string 
     1166  Otherwise, each language code, and each Unicode string in the Unicode string
    11671167  table are freed, and EFI_SUCCESS is returned.
    11681168
     
    12181218  [ATTENTION] This function will be deprecated for security reason.
    12191219
    1220   Returns a pointer to an allocated buffer that contains the contents of a 
    1221   variable retrieved through the UEFI Runtime Service GetVariable().  The 
     1220  Returns a pointer to an allocated buffer that contains the contents of a
     1221  variable retrieved through the UEFI Runtime Service GetVariable().  The
    12221222  returned buffer is allocated using AllocatePool().  The caller is responsible
    12231223  for freeing this buffer with FreePool().
     
    12811281  [ATTENTION] This function will be deprecated for security reason.
    12821282
    1283   Returns a pointer to an allocated buffer that contains the contents of a 
    1284   variable retrieved through the UEFI Runtime Service GetVariable().  This 
     1283  Returns a pointer to an allocated buffer that contains the contents of a
     1284  variable retrieved through the UEFI Runtime Service GetVariable().  This
    12851285  function always uses the EFI_GLOBAL_VARIABLE GUID to retrieve variables.
    1286   The returned buffer is allocated using AllocatePool().  The caller is 
     1286  The returned buffer is allocated using AllocatePool().  The caller is
    12871287  responsible for freeing this buffer with FreePool().
    12881288
     
    13071307
    13081308/**
    1309   Returns the status whether get the variable success. The function retrieves 
    1310   variable  through the UEFI Runtime Service GetVariable().  The 
     1309  Returns the status whether get the variable success. The function retrieves
     1310  variable  through the UEFI Runtime Service GetVariable().  The
    13111311  returned buffer is allocated using AllocatePool().  The caller is responsible
    13121312  for freeing this buffer with FreePool().
     
    13481348    *Size  = 0;
    13491349  }
    1350  
     1350
    13511351  Status = gRT->GetVariable ((CHAR16 *) Name, (EFI_GUID *) Guid, NULL, &BufferSize, *Value);
    13521352  if (Status != EFI_BUFFER_TOO_SMALL) {
     
    13801380
    13811381/**
    1382   Returns a pointer to an allocated buffer that contains the contents of a 
    1383   variable retrieved through the UEFI Runtime Service GetVariable().  This 
     1382  Returns a pointer to an allocated buffer that contains the contents of a
     1383  variable retrieved through the UEFI Runtime Service GetVariable().  This
    13841384  function always uses the EFI_GLOBAL_VARIABLE GUID to retrieve variables.
    1385   The returned buffer is allocated using AllocatePool().  The caller is 
     1385  The returned buffer is allocated using AllocatePool().  The caller is
    13861386  responsible for freeing this buffer with FreePool().
    13871387
     
    14101410
    14111411/**
    1412   Returns a pointer to an allocated buffer that contains the best matching language 
    1413   from a set of supported languages. 
    1414  
    1415   This function supports both ISO 639-2 and RFC 4646 language codes, but language 
    1416   code types may not be mixed in a single call to this function.  The language 
    1417   code returned is allocated using AllocatePool().  The caller is responsible for 
     1412  Returns a pointer to an allocated buffer that contains the best matching language
     1413  from a set of supported languages.
     1414
     1415  This function supports both ISO 639-2 and RFC 4646 language codes, but language
     1416  code types may not be mixed in a single call to this function.  The language
     1417  code returned is allocated using AllocatePool().  The caller is responsible for
    14181418  freeing the allocated buffer using FreePool().  This function supports a variable
    1419   argument list that allows the caller to pass in a prioritized list of language 
    1420   codes to test against all the language codes in SupportedLanguages. 
     1419  argument list that allows the caller to pass in a prioritized list of language
     1420  codes to test against all the language codes in SupportedLanguages.
    14211421
    14221422  If SupportedLanguages is NULL, then ASSERT().
    14231423
    14241424  @param[in]  SupportedLanguages  A pointer to a Null-terminated ASCII string that
    1425                                   contains a set of language codes in the format 
     1425                                  contains a set of language codes in the format
    14261426                                  specified by Iso639Language.
    14271427  @param[in]  Iso639Language      If TRUE, then all language codes are assumed to be
    14281428                                  in ISO 639-2 format.  If FALSE, then all language
    14291429                                  codes are assumed to be in RFC 4646 language format
    1430   @param[in]  ...                 A variable argument list that contains pointers to 
     1430  @param[in]  ...                 A variable argument list that contains pointers to
    14311431                                  Null-terminated ASCII strings that contain one or more
    14321432                                  language codes in the format specified by Iso639Language.
    14331433                                  The first language code from each of these language
    14341434                                  code lists is used to determine if it is an exact or
    1435                                   close match to any of the language codes in 
     1435                                  close match to any of the language codes in
    14361436                                  SupportedLanguages.  Close matches only apply to RFC 4646
    14371437                                  language codes, and the matching algorithm from RFC 4647
    1438                                   is used to determine if a close match is present.  If 
     1438                                  is used to determine if a close match is present.  If
    14391439                                  an exact or close match is found, then the matching
    14401440                                  language code from SupportedLanguages is returned.  If
    14411441                                  no matches are found, then the next variable argument
    1442                                   parameter is evaluated.  The variable argument list 
     1442                                  parameter is evaluated.  The variable argument list
    14431443                                  is terminated by a NULL.
    14441444
    14451445  @retval NULL   The best matching language could not be found in SupportedLanguages.
    1446   @retval NULL   There are not enough resources available to return the best matching 
     1446  @retval NULL   There are not enough resources available to return the best matching
    14471447                 language.
    1448   @retval Other  A pointer to a Null-terminated ASCII string that is the best matching 
     1448  @retval Other  A pointer to a Null-terminated ASCII string that is the best matching
    14491449                 language in SupportedLanguages.
    14501450
     
    14531453EFIAPI
    14541454GetBestLanguage (
    1455   IN CONST CHAR8  *SupportedLanguages, 
     1455  IN CONST CHAR8  *SupportedLanguages,
    14561456  IN BOOLEAN      Iso639Language,
    14571457  ...
     
    15321532      } else {
    15331533        //
    1534         // If RFC 4646 mode, then trim Language from the right to the next '-' character 
     1534        // If RFC 4646 mode, then trim Language from the right to the next '-' character
    15351535        //
    15361536        for (LanguageLength--; LanguageLength > 0 && Language[LanguageLength] != '-'; LanguageLength--);
     
    15411541
    15421542  //
    1543   // No matches were found 
     1543  // No matches were found
    15441544  //
    15451545  return NULL;
  • trunk/src/VBox/Devices/EFI/Firmware/MdePkg/Library/UefiLib/UefiLib.inf

    r58459 r58466  
    22# Instance of UEFI Library.
    33#
    4 # The UEFI Library provides functions and macros that simplify the development of 
    5 #  UEFI Drivers and UEFI Applications.  These functions and macros help manage EFI 
    6 #  events, build simple locks utilizing EFI Task Priority Levels (TPLs), install 
    7 #  EFI Driver Model related protocols, manage Unicode string tables for UEFI Drivers, 
     4# The UEFI Library provides functions and macros that simplify the development of
     5#  UEFI Drivers and UEFI Applications.  These functions and macros help manage EFI
     6#  events, build simple locks utilizing EFI Task Priority Levels (TPLs), install
     7#  EFI Driver Model related protocols, manage Unicode string tables for UEFI Drivers,
    88#  and print messages on the console output and standard error devices.
    99#
     
    5858  DevicePathLib
    5959  UefiRuntimeServicesTableLib
    60  
     60
    6161[Guids]
    6262  gEfiEventReadyToBootGuid                      ## SOMETIMES_CONSUMES  ## Event
  • trunk/src/VBox/Devices/EFI/Firmware/MdePkg/Library/UefiLib/UefiLibPrint.c

    r48674 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   A Null-terminated Unicode format string.
    107   @param ...      A Variable argument list whose contents are accessed based 
     107  @param ...      A Variable argument list whose contents are accessed based
    108108                  on the format string specified by Format.
    109  
     109
    110110  @return The 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   A 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 The 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   A 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 The 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   A 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 The number of ASCII characters printed to ConErr.
    284284
     
    372372
    373373  ConsoleHandle = gST->ConsoleOutHandle;
    374  
     374
    375375  ASSERT( ConsoleHandle != NULL);
    376376
     
    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       A Null-terminated Unicode format string.  See Print Library 
     589  @param  Format       A Null-terminated Unicode format string.  See Print Library
    590590                       for the supported format string syntax.
    591   @param  ...          A Variable argument list whose contents are accessed based on 
    592                        the format string specified by Format.         
     591  @param  ...          A 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       A Null-terminated ASCII format string.  See Print Library 
     668  @param  Format       A 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/MdePkg/Library/UefiLib/UefiNotTiano.c

    r58459 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               The pointer to the notification function's context,
     
    7676/**
    7777  Create an EFI event in the Legacy Boot Event Group and allows
    78   the caller to specify a notification function. 
    79  
     78  the caller to specify a notification function.
     79
    8080  This function abstracts the creation of the Legacy Boot Event.
    8181  The Framework moved from a proprietary to UEFI 2.0 based mechanism.
     
    142142
    143143  Prior to UEFI 2.0 this was done via a non-standard UEFI extension, and this library
    144   abstracts the implementation mechanism of this event from the caller.   
    145   This function abstracts the creation of the Ready to Boot Event.  The Framework 
    146   moved from a proprietary to UEFI 2.0-based mechanism.  This library abstracts 
    147   the caller from how this event is created to prevent the code form having to 
     144  abstracts the implementation mechanism of this event from the caller.
     145  This function abstracts the creation of the Ready to Boot Event.  The Framework
     146  moved from a proprietary to UEFI 2.0-based mechanism.  This library abstracts
     147  the caller from how this event is created to prevent the code form having to
    148148  change with the version of the specification supported.
    149149  If ReadyToBootEvent is NULL, then ASSERT().
     
    171171/**
    172172  Create an EFI event in the Ready To Boot Event Group and allows
    173   the caller to specify a notification function. 
    174  
     173  the caller to specify a notification function.
     174
    175175  This function abstracts the creation of the Ready to Boot Event.
    176176  The Framework moved from a proprietary to UEFI 2.0 based mechanism.
     
    236236/**
    237237  Create, Signal, and Close the Ready to Boot event using EfiSignalEventReadyToBoot().
    238  
     238
    239239  This function abstracts the signaling of the Ready to Boot Event. The Framework moved
    240240  from a proprietary to UEFI 2.0 based mechanism. This library abstracts the caller
     
    286286
    287287/**
    288   Check to see if the Firmware Volume (FV) Media Device Path is valid 
    289  
    290   The Framework FwVol Device Path changed to conform to the UEFI 2.0 specification. 
     288  Check to see if the Firmware Volume (FV) Media Device Path is valid
     289
     290  The Framework FwVol Device Path changed to conform to the UEFI 2.0 specification.
    291291  This library function abstracts validating a device path node.
    292   Check the MEDIA_FW_VOL_FILEPATH_DEVICE_PATH data structure to see if it's valid. 
    293   If it is valid, then return the GUID file name from the device path node.  Otherwise, 
    294   return NULL.  This device path changed in the DXE CIS version 0.92 in a non back ward 
    295   compatible way to not conflict with the UEFI 2.0 specification.  This function abstracts 
     292  Check the MEDIA_FW_VOL_FILEPATH_DEVICE_PATH data structure to see if it's valid.
     293  If it is valid, then return the GUID file name from the device path node.  Otherwise,
     294  return NULL.  This device path changed in the DXE CIS version 0.92 in a non back ward
     295  compatible way to not conflict with the UEFI 2.0 specification.  This function abstracts
    296296  the differences from the caller.
    297297  If FvDevicePathNode is NULL, then ASSERT().
     
    322322/**
    323323  Initialize a Firmware Volume (FV) Media Device Path node.
    324  
    325   The Framework FwVol Device Path changed to conform to the UEFI 2.0 specification. 
    326   This library function abstracts initializing a device path node. 
    327   Initialize the MEDIA_FW_VOL_FILEPATH_DEVICE_PATH data structure.  This device 
    328   path changed in the DXE CIS version 0.92 in a non back ward compatible way to 
    329   not conflict with the UEFI 2.0 specification.  This function abstracts the 
     324
     325  The Framework FwVol Device Path changed to conform to the UEFI 2.0 specification.
     326  This library function abstracts initializing a device path node.
     327  Initialize the MEDIA_FW_VOL_FILEPATH_DEVICE_PATH data structure.  This device
     328  path changed in the DXE CIS version 0.92 in a non back ward compatible way to
     329  not conflict with the UEFI 2.0 specification.  This function abstracts the
    330330  differences from the caller.
    331331  If FvDevicePathNode is NULL, then ASSERT().
    332332  If NameGuid is NULL, then ASSERT().
    333  
     333
    334334  @param  FvDevicePathNode  The pointer to a FV device path node to initialize
    335335  @param  NameGuid          FV file name to use in FvDevicePathNode
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