git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@10404 6f19259b-4bc3-4df7-8a09-765794883524
		
			
				
	
	
		
			69 lines
		
	
	
		
			2.5 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			69 lines
		
	
	
		
			2.5 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /** @file
 | |
|   This file declares FindFv PPI, which is used to locate FVs that contain PEIMs in PEI.
 | |
| 
 | |
| Copyright (c) 2007 - 2010, Intel Corporation. All rights reserved.<BR>
 | |
| This program and the accompanying materials are licensed and made available under 
 | |
| the terms and conditions of the BSD License that 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.
 | |
| 
 | |
|   @par Revision Reference:
 | |
|   This PPI is defined in PEI CIS
 | |
|   Version 0.91.
 | |
| 
 | |
| **/
 | |
| 
 | |
| #ifndef _FIND_FV_H_
 | |
| #define _FIND_FV_H_
 | |
| 
 | |
| ///
 | |
| ///  Inconsistent with specification here: 
 | |
| ///  GUID value format has been changed to the standard GUID format.
 | |
| ///
 | |
| #define EFI_PEI_FIND_FV_PPI_GUID \
 | |
|   { \
 | |
|     0x36164812, 0xa023, 0x44e5, {0xbd, 0x85, 0x5, 0xbf, 0x3c, 0x77, 0x0, 0xaa } \
 | |
|   }
 | |
| 
 | |
| typedef struct _EFI_PEI_FIND_FV_PPI EFI_PEI_FIND_FV_PPI;
 | |
| 
 | |
| /**
 | |
|   This interface returns the base address of the firmware volume whose index
 | |
|   was passed in FvNumber. Once this function reports a firmware volume
 | |
|   index/base address pair, that index/address pairing must continue throughout PEI.
 | |
| 
 | |
|   @param  PeiServices    The pointer to the PEI Services Table.
 | |
|   @param  This           Interface pointer that implements the Find FV service.
 | |
|   @param  FvNumber       The index of the firmware volume to locate.
 | |
|   @param  FvAddress      The address of the volume to discover.
 | |
| 
 | |
|   @retval EFI_SUCCESS           An additional firmware volume was found.
 | |
|   @retval EFI_OUT_OF_RESOURCES  There are no firmware volumes for the given FvNumber.
 | |
|   @retval EFI_INVALID_PARAMETER *FvAddress is NULL.
 | |
| 
 | |
| **/
 | |
| typedef
 | |
| EFI_STATUS
 | |
| (EFIAPI *EFI_PEI_FIND_FV_FINDFV)(
 | |
|   IN EFI_PEI_FIND_FV_PPI             *This,
 | |
|   IN EFI_PEI_SERVICES                **PeiServices,
 | |
|   IN UINT8                           *FvNumber,
 | |
|   IN OUT EFI_FIRMWARE_VOLUME_HEADER  **FVAddress
 | |
|   );
 | |
| 
 | |
| /**
 | |
|   Hardware mechanisms for locating FVs in a platform vary widely.
 | |
|   EFI_PEI_FIND_FV_PPI serves to abstract this variation so that the
 | |
|   PEI Foundation can remain standard across a wide variety of platforms.
 | |
| **/
 | |
| struct _EFI_PEI_FIND_FV_PPI {
 | |
|   EFI_PEI_FIND_FV_FINDFV  FindFv;   ///< Service that abstracts the location of additional firmware volumes.
 | |
| };
 | |
| 
 | |
| extern EFI_GUID gEfiFindFvPpiGuid;
 | |
| 
 | |
| #endif
 |