git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@5109 6f19259b-4bc3-4df7-8a09-765794883524
		
			
				
	
	
		
			103 lines
		
	
	
		
			2.9 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			103 lines
		
	
	
		
			2.9 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/** @file
 | 
						|
  HII Library implementation that uses DXE protocols and services.
 | 
						|
 | 
						|
  Copyright (c) 2006, Intel Corporation<BR>
 | 
						|
  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.
 | 
						|
 | 
						|
**/
 | 
						|
 | 
						|
 | 
						|
#include <FrameworkDxe.h>
 | 
						|
 | 
						|
 | 
						|
#include <Protocol/FrameworkHii.h>
 | 
						|
 | 
						|
#include <Library/HiiLib.h>
 | 
						|
#include <Library/DebugLib.h>
 | 
						|
#include <Library/UefiBootServicesTableLib.h>
 | 
						|
#include <Library/MemoryAllocationLib.h>
 | 
						|
 | 
						|
EFI_HII_PROTOCOL      *gHiiProtocol = NULL;
 | 
						|
 | 
						|
/**
 | 
						|
  The constructor function for HiiLibFramework library instance
 | 
						|
 | 
						|
  The constructor function locates Hii protocol from protocol database.
 | 
						|
  It will ASSERT() if that operation fails and it will always return EFI_SUCCESS.
 | 
						|
 | 
						|
  @param  ImageHandle   The firmware allocated handle for the EFI image.
 | 
						|
  @param  SystemTable   A pointer to the EFI System Table.
 | 
						|
 | 
						|
  @retval EFI_SUCCESS   The constructor always returns EFI_SUCCESS.
 | 
						|
 | 
						|
**/
 | 
						|
EFI_STATUS
 | 
						|
EFIAPI
 | 
						|
HiiLibFrameworkConstructor (
 | 
						|
  IN      EFI_HANDLE                ImageHandle,
 | 
						|
  IN      EFI_SYSTEM_TABLE          *SystemTable
 | 
						|
  )
 | 
						|
{
 | 
						|
  EFI_STATUS Status;
 | 
						|
 | 
						|
  Status = gBS->LocateProtocol (
 | 
						|
                  &gEfiHiiProtocolGuid,
 | 
						|
                  NULL,
 | 
						|
                  (VOID **) &gHiiProtocol
 | 
						|
                  );
 | 
						|
  ASSERT_EFI_ERROR (Status);
 | 
						|
 | 
						|
  return Status;
 | 
						|
  
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
  This function allocates pool for an EFI_HII_PACKAGES structure
 | 
						|
  with enough space for the variable argument list of package pointers.
 | 
						|
  The allocated structure is initialized using NumberOfPackages, Guid,
 | 
						|
  and the variable length argument list of package pointers.
 | 
						|
 | 
						|
  @param  NumberOfPackages The number of HII packages to prepare.
 | 
						|
  @param  Guid             Package GUID.
 | 
						|
  @param  Args             Package contents
 | 
						|
 | 
						|
  @return The allocated and initialized packages.
 | 
						|
 | 
						|
**/
 | 
						|
EFI_HII_PACKAGES *
 | 
						|
InternalPreparePackages (
 | 
						|
  IN UINTN           NumberOfPackages,
 | 
						|
  IN CONST EFI_GUID  *Guid OPTIONAL,
 | 
						|
  IN VA_LIST         Args
 | 
						|
  )
 | 
						|
{
 | 
						|
  EFI_HII_PACKAGES  *HiiPackages;
 | 
						|
  VOID              **Package;
 | 
						|
  UINTN             Index;
 | 
						|
 | 
						|
  ASSERT (NumberOfPackages > 0);
 | 
						|
 | 
						|
  HiiPackages                   = AllocateZeroPool (sizeof (EFI_HII_PACKAGES) + NumberOfPackages * sizeof (VOID *));
 | 
						|
  ASSERT (HiiPackages != NULL);
 | 
						|
 | 
						|
  HiiPackages->GuidId           = (EFI_GUID *) Guid;
 | 
						|
  HiiPackages->NumberOfPackages = NumberOfPackages;
 | 
						|
  Package                       = (VOID **) (((UINT8 *) HiiPackages) + sizeof (EFI_HII_PACKAGES));
 | 
						|
 | 
						|
  for (Index = 0; Index < NumberOfPackages; Index++) {
 | 
						|
    *Package = VA_ARG (Args, VOID *);
 | 
						|
    Package++;
 | 
						|
  }
 | 
						|
 | 
						|
  return HiiPackages;
 | 
						|
 | 
						|
}
 | 
						|
 | 
						|
 |