Enabling EFI_PEI_FIRMWARE_VOLUME_PPI introduced by PI1.2.

1, Implement EFI_PEI_FIRMWARE_VOLUME_PPI for FFS2 format as build-in supporting FV format in PeiCore.
2, Reduce the assumption of memory-mapped FV in PeiCore. PeiCore should access FV via EFI_PEI_FIRMWARE_VOLUME_PPI interface but not cast FvHandle/FileHandle to EFI_FIRMWARE_VOLUME_HEADER/EFI_FV_FILE_HEADER directly.
3, Reduce AllFv[] and AllFvCount in PEI_CORE_INSTANCE structure. Original PEI_CORE_INSTANCE use AllFv[] and Fv[] array to manage discovered FV and dispatched FV. But not need to make thing too complex. Now PEI_CORE_FV_HANDLE array of Fv[] will take responsibility to manage all FV instance and status.
4, Fix the bug use PeiDispatcher use wrong index for PeiFfsFindNextVolume(), 
5, Fix the bug in PeiFfsFindNextVolume(), if instance is not found, *VolumeHandle should be set to NULL but not VolumeHandle was set to NULL.

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@9407 6f19259b-4bc3-4df7-8a09-765794883524

1 files changed, 238 insertions, 0 deletions

diff --git a/MdeModulePkg/Core/Pei/FwVol/FwVol.h b/MdeModulePkg/Core/Pei/FwVol/FwVol.h
new file mode 100644
index 0000000000..65c17e3d09
--- /dev/null
+++ b/MdeModulePkg/Core/Pei/FwVol/FwVol.h
@@ -0,0 +1,238 @@
+/** @file

+  The internal header file for firmware volume related definitions.

+  

+Copyright (c) 2009, 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.             

+

+**/

+

+#ifndef _FWVOL_H_

+#define _FWVOL_H_

+

+#include "PeiMain.h"

+

+#define GET_OCCUPIED_SIZE(ActualSize, Alignment) \

+  ((ActualSize) + (((Alignment) - ((ActualSize) & ((Alignment) - 1))) & ((Alignment) - 1)))

+

+

+/**

+  Process a firmware volume and create a volume handle.

+

+  Create a volume handle from the information in the buffer. For

+  memory-mapped firmware volumes, Buffer and BufferSize refer to

+  the start of the firmware volume and the firmware volume size.

+  For non memory-mapped firmware volumes, this points to a

+  buffer which contains the necessary information for creating

+  the firmware volume handle. Normally, these values are derived

+  from the EFI_FIRMWARE_VOLUME_INFO_PPI.

+  

+  

+  @param This                   Points to this instance of the

+                                EFI_PEI_FIRMWARE_VOLUME_PPI.

+  @param Buffer                 Points to the start of the buffer.

+  @param BufferSize             Size of the buffer.

+  @param FvHandle               Points to the returned firmware volume

+                                handle. The firmware volume handle must

+                                be unique within the system. 

+

+  @retval EFI_SUCCESS           Firmware volume handle created.

+  @retval EFI_VOLUME_CORRUPTED  Volume was corrupt.

+

+**/

+EFI_STATUS

+EFIAPI

+PeiFfs2FvPpiProcessVolume (

+  IN  CONST  EFI_PEI_FIRMWARE_VOLUME_PPI *This,

+  IN  VOID                               *Buffer,

+  IN  UINTN                              BufferSize,

+  OUT EFI_PEI_FV_HANDLE                  *FvHandle

+  );

+  

+/**

+  Finds the next file of the specified type.

+

+  This service enables PEI modules to discover additional firmware files. 

+  The FileHandle must be unique within the system.

+

+  @param This           Points to this instance of the

+                        EFI_PEI_FIRMWARE_VOLUME_PPI.

+  @param SearchType     A filter to find only files of this type. Type

+                        EFI_FV_FILETYPE_ALL causes no filtering to be

+                        done.

+  @param FvHandle       Handle of firmware volume in which to

+                        search.

+  @param FileHandle     Points to the current handle from which to

+                        begin searching or NULL to start at the

+                        beginning of the firmware volume. Updated

+                        upon return to reflect the file found.

+

+  @retval EFI_SUCCESS   The file was found.

+  @retval EFI_NOT_FOUND The file was not found. FileHandle contains NULL.

+

+**/  

+EFI_STATUS

+EFIAPI

+PeiFfs2FvPpiFindFileByType (

+  IN CONST  EFI_PEI_FIRMWARE_VOLUME_PPI *This,

+  IN        EFI_FV_FILETYPE             SearchType,

+  IN        EFI_PEI_FV_HANDLE           FvHandle,

+  IN OUT    EFI_PEI_FILE_HANDLE         *FileHandle

+  );

+

+/**

+  Find a file within a volume by its name. 

+  

+  This service searches for files with a specific name, within

+  either the specified firmware volume or all firmware volumes.

+

+  @param This                   Points to this instance of the

+                                EFI_PEI_FIRMWARE_VOLUME_PPI.

+  @param FileName               A pointer to the name of the file to find

+                                within the firmware volume.

+  @param FvHandle               Upon entry, the pointer to the firmware

+                                volume to search or NULL if all firmware

+                                volumes should be searched. Upon exit, the

+                                actual firmware volume in which the file was

+                                found.

+  @param FileHandle             Upon exit, points to the found file's

+                                handle or NULL if it could not be found.

+

+  @retval EFI_SUCCESS           File was found.

+  @retval EFI_NOT_FOUND         File was not found.

+  @retval EFI_INVALID_PARAMETER FvHandle or FileHandle or

+                                FileName was NULL.

+

+

+**/    

+EFI_STATUS

+EFIAPI

+PeiFfs2FvPpiFindFileByName (

+  IN  CONST  EFI_PEI_FIRMWARE_VOLUME_PPI *This,

+  IN  CONST  EFI_GUID                    *FileName,

+  IN  EFI_PEI_FV_HANDLE                  *FvHandle,

+  OUT EFI_PEI_FILE_HANDLE                *FileHandle  

+  );

+

+/**

+  Find the next matching section in the firmware file.

+  

+  This service enables PEI modules to discover sections

+  of a given type within a valid file.

+  

+  @param This             Points to this instance of the

+                          EFI_PEI_FIRMWARE_VOLUME_PPI.

+  @param SearchType       A filter to find only sections of this

+                          type.

+  @param FileHandle       Handle of firmware file in which to

+                          search.

+  @param SectionData      Updated upon  return to point to the

+                          section found.

+  

+  @retval EFI_SUCCESS     Section was found.

+  @retval EFI_NOT_FOUND   Section of the specified type was not

+                          found. SectionData contains NULL.

+**/      

+EFI_STATUS

+EFIAPI

+PeiFfs2FvPpiFindSectionByType (

+  IN  CONST EFI_PEI_FIRMWARE_VOLUME_PPI    *This,

+  IN        EFI_SECTION_TYPE               SearchType,

+  IN        EFI_PEI_FILE_HANDLE            FileHandle,

+  OUT VOID                                 **SectionData

+  );

+

+/**

+  Returns information about a specific file.

+

+  This function returns information about a specific

+  file, including its file name, type, attributes, starting

+  address and size. 

+   

+  @param This                     Points to this instance of the

+                                  EFI_PEI_FIRMWARE_VOLUME_PPI.

+  @param FileHandle               Handle of the file.

+  @param FileInfo                 Upon exit, points to the file's

+                                  information.

+

+  @retval EFI_SUCCESS             File information returned.

+  @retval EFI_INVALID_PARAMETER   If FileHandle does not

+                                  represent a valid file.

+  @retval EFI_INVALID_PARAMETER   If FileInfo is NULL.

+  

+**/         

+EFI_STATUS

+EFIAPI

+PeiFfs2FvPpiGetFileInfo (

+  IN  CONST EFI_PEI_FIRMWARE_VOLUME_PPI   *This, 

+  IN        EFI_PEI_FILE_HANDLE           FileHandle, 

+  OUT       EFI_FV_FILE_INFO              *FileInfo

+  );

+

+/**

+  This function returns information about the firmware volume.

+  

+  @param This                     Points to this instance of the

+                                  EFI_PEI_FIRMWARE_VOLUME_PPI.

+  @param FvHandle                 Handle to the firmware handle.

+  @param VolumeInfo               Points to the returned firmware volume

+                                  information.

+

+  @retval EFI_SUCCESS             Information returned successfully.

+  @retval EFI_INVALID_PARAMETER   FvHandle does not indicate a valid

+                                  firmware volume or VolumeInfo is NULL.

+

+**/            

+EFI_STATUS

+EFIAPI

+PeiFfs2FvPpiGetVolumeInfo (

+  IN  CONST  EFI_PEI_FIRMWARE_VOLUME_PPI   *This, 

+  IN  EFI_PEI_FV_HANDLE                    FvHandle, 

+  OUT EFI_FV_INFO                          *VolumeInfo

+  );

+

+/**

+  Convert the handle of FV to pointer of corresponding PEI_CORE_FV_HANDLE.

+  

+  @param FvHandle   The handle of a FV.

+  

+  @retval NULL if can not find.

+  @return Pointer of corresponding PEI_CORE_FV_HANDLE. 

+**/

+PEI_CORE_FV_HANDLE *

+FvHandleToCoreHandle (

+  IN EFI_PEI_FV_HANDLE  FvHandle

+  );

+  

+/**

+  Given the input file pointer, search for the next matching file in the

+  FFS volume as defined by SearchType. The search starts from FileHeader inside

+  the Firmware Volume defined by FwVolHeader.

+

+

+  @param FvHandle        Pointer to the FV header of the volume to search

+  @param FileName        File name

+  @param SearchType      Filter to find only files of this type.

+                         Type EFI_FV_FILETYPE_ALL causes no filtering to be done.

+  @param FileHandle      This parameter must point to a valid FFS volume.

+  @param AprioriFile     Pointer to AprioriFile image in this FV if has

+

+  @return EFI_NOT_FOUND  No files matching the search criteria were found

+  @retval EFI_SUCCESS    Success to search given file

+

+**/

+EFI_STATUS

+FindFileEx (

+  IN  CONST EFI_PEI_FV_HANDLE        FvHandle,

+  IN  CONST EFI_GUID                 *FileName,   OPTIONAL

+  IN        EFI_FV_FILETYPE          SearchType,

+  IN OUT    EFI_PEI_FILE_HANDLE      *FileHandle,

+  IN OUT    EFI_PEI_FV_HANDLE        *AprioriFile  OPTIONAL

+  );

+

+#endif