git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@2368 6f19259b-4bc3-4df7-8a09-765794883524
		
			
				
	
	
		
			137 lines
		
	
	
		
			3.1 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			137 lines
		
	
	
		
			3.1 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/*++
 | 
						|
 | 
						|
Copyright (c) 2006, Intel Corporation                                                         
 | 
						|
All rights reserved. This program and the accompanying materials                          
 | 
						|
are licensed and made available under the terms and conditions of the BSD License         
 | 
						|
which accompanies this distribution.  The full text of the license may be found at        
 | 
						|
http://opensource.org/licenses/bsd-license.php                                            
 | 
						|
                                                                                          
 | 
						|
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     
 | 
						|
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             
 | 
						|
 | 
						|
Module Name:
 | 
						|
 | 
						|
  string.c
 | 
						|
 | 
						|
Abstract:
 | 
						|
 | 
						|
  String support
 | 
						|
 | 
						|
Revision History
 | 
						|
 | 
						|
--*/
 | 
						|
 | 
						|
#include "Bds.h"
 | 
						|
#include "String.h"
 | 
						|
#include "Language.h"
 | 
						|
 | 
						|
extern UINT8  EdkGenericPlatformBdsLibStrings[];
 | 
						|
 | 
						|
EFI_GUID      gBdsStringPackGuid = { 0x7bac95d3, 0xddf, 0x42f3, {0x9e, 0x24, 0x7c, 0x64, 0x49, 0x40, 0x37, 0x9a} };
 | 
						|
 | 
						|
EFI_HII_HANDLE    gStringPackHandle;
 | 
						|
EFI_HII_PROTOCOL  *Hii;
 | 
						|
 | 
						|
EFI_STATUS
 | 
						|
InitializeStringSupport (
 | 
						|
  VOID
 | 
						|
  )
 | 
						|
/*++
 | 
						|
 | 
						|
Routine Description:
 | 
						|
  
 | 
						|
  Initialize HII global accessor for string support
 | 
						|
 | 
						|
Arguments:
 | 
						|
  None
 | 
						|
 | 
						|
Returns:
 | 
						|
  String from ID.
 | 
						|
 | 
						|
--*/
 | 
						|
{
 | 
						|
  EFI_STATUS        Status;
 | 
						|
  EFI_HII_PACKAGES  *PackageList;
 | 
						|
  //
 | 
						|
  // There should only ever be one HII protocol
 | 
						|
  //
 | 
						|
  Status = gBS->LocateProtocol (
 | 
						|
                  &gEfiHiiProtocolGuid,
 | 
						|
                  NULL,
 | 
						|
                  (VOID**)&Hii
 | 
						|
                  );
 | 
						|
  if (!EFI_ERROR (Status)) {
 | 
						|
    PackageList = PreparePackages (1, &gBdsStringPackGuid, EdkGenericPlatformBdsLibStrings);
 | 
						|
    Status      = Hii->NewPack (Hii, PackageList, &gStringPackHandle);
 | 
						|
    gBS->FreePool (PackageList);
 | 
						|
  }
 | 
						|
 | 
						|
  return Status;
 | 
						|
}
 | 
						|
 | 
						|
CHAR16 *
 | 
						|
GetStringById (
 | 
						|
  IN  STRING_REF   Id
 | 
						|
  )
 | 
						|
/*++
 | 
						|
 | 
						|
Routine Description:
 | 
						|
 | 
						|
  Get string by string id from HII Interface
 | 
						|
 | 
						|
Arguments:
 | 
						|
 | 
						|
  Id       - String ID.
 | 
						|
           
 | 
						|
Returns:
 | 
						|
 | 
						|
  CHAR16 * - String from ID.
 | 
						|
  NULL     - If error occurs.
 | 
						|
 | 
						|
--*/
 | 
						|
{
 | 
						|
  CHAR16      *String;
 | 
						|
  UINTN       StringLength;
 | 
						|
  EFI_STATUS  Status;
 | 
						|
 | 
						|
  //
 | 
						|
  // Set default string size assumption at no more than 256 bytes
 | 
						|
  //
 | 
						|
  StringLength  = 0x100;
 | 
						|
 | 
						|
  String        = AllocateZeroPool (StringLength);
 | 
						|
  if (String == NULL) {
 | 
						|
    //
 | 
						|
    // If this happens, we are oh-so-dead, but return a NULL in any case.
 | 
						|
    //
 | 
						|
    return NULL;
 | 
						|
  }
 | 
						|
  //
 | 
						|
  // Get the current string for the current Language
 | 
						|
  //
 | 
						|
  Status = Hii->GetString (Hii, gStringPackHandle, Id, FALSE, NULL, &StringLength, String);
 | 
						|
  if (EFI_ERROR (Status)) {
 | 
						|
    if (Status == EFI_BUFFER_TOO_SMALL) {
 | 
						|
      //
 | 
						|
      // Free the old pool
 | 
						|
      //
 | 
						|
      gBS->FreePool (String);
 | 
						|
 | 
						|
      //
 | 
						|
      // Allocate new pool with correct value
 | 
						|
      //
 | 
						|
      String = AllocatePool (StringLength);
 | 
						|
      ASSERT (String != NULL);
 | 
						|
 | 
						|
      Status = Hii->GetString (Hii, gStringPackHandle, Id, FALSE, NULL, &StringLength, String);
 | 
						|
      if (!EFI_ERROR (Status)) {
 | 
						|
        return String;
 | 
						|
      }
 | 
						|
    }
 | 
						|
 | 
						|
    return NULL;
 | 
						|
  }
 | 
						|
 | 
						|
  return String;
 | 
						|
}
 |