Add the following PI 1.2 PPIs to the MdePkg

1) Block I/O PPI 
2) Device Recovery PPI 
3) Recovery Module PPI
4) S3 Resume PPI

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

MdePkg/Include/Ppi/RecoveryModule.h

@@ -0,0 +1,91 @@
+/** @file
+  This file declares Recovery Module PPI.  This PPI is used to find and load the
+  recovery files.
+
+  A module that produces this PPI has many roles and is responsible for the following:
+    -# Calling the driver recovery PPI EFI_PEI_DEVICE_RECOVERY_MODULE_PPI.
+       GetNumberRecoveryCapsules() to determine if one or more DXE recovery 
+       entities exist.
+    -# If no capsules exist, then performing appropriate error handling.
+    -# Allocating a buffer of MaxRecoveryCapsuleSize as determined by
+       EFI_PEI_DEVICE_RECOVERY_MODULE_PPI.GetNumberRecoveryCapsules() or
+       larger.
+    -# Determining the policy in which DXE recovery capsules are loaded.
+    -# Calling the driver recovery PPI EFI_PEI_DEVICE_RECOVERY_MODULE_PPI.
+       LoadRecoveryCapsule() for capsule number x.
+    -# If the load failed, performing appropriate error handling.
+    -# Performing security checks for a loaded DXE recovery capsule.
+    -# If the security checks failed, then logging the failure in a data HOB.
+    -# If the security checks failed, then determining the next 
+       EFI_PEI_DEVICE_RECOVERY_MODULE_PPI.LoadRecoveryCapsule()capsule number; 
+       otherwise, go to step 11.
+    -# If more DXE recovery capsules exist, then go to step 5; otherwise, perform 
+       error handling.
+    -# Decomposing the capsule loaded by EFI_PEI_DEVICE_RECOVERY_MODULE_PPI.
+       LoadRecoveryCapsule() into its components. It is assumed that the path 
+       parameters are redundant for recovery and Setup parameters are either 
+       redundant or canned.
+    -# Invalidating all HOB entries for updateable firmware volume entries. 
+       This invalidation prevents possible errant drivers from being executed.
+    -# Updating the HOB table with the recovery DXE firmware volume information 
+       generated from the capsule decomposition.
+    -# Returning to the PEI Dispatcher.  
+  
+  Copyright (c) 2007 - 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.
+
+  @par Revision Reference:
+  This PPI is defined in UEFI Platform Initialization Specification 1.2 Volume 1: 
+  Pre-EFI Initalization Core Interface
+
+**/
+
+#ifndef __PEI_RECOVERY_MODULE_PPI_H__
+#define __PEI_RECOVERY_MODULE_PPI_H__
+
+///
+///  Inconsistent with specification here: 
+///  GUID marco name has been changed to the consistent PPI GUID macro name.
+///
+#define EFI_PEI_RECOVERY_MODULE_PPI_GUID \
+  { \
+    0xFB6D9542, 0x612D, 0x4f45, {0x87, 0x2F, 0x5C, 0xFF, 0x52, 0xE9, 0x3D, 0xCF } \
+  }
+
+typedef struct _EFI_PEI_RECOVERY_MODULE_PPI EFI_PEI_RECOVERY_MODULE_PPI;
+
+/**
+  Loads a DXE capsule from some media into memory and updates the HOB table
+  with the DXE firmware volume information.
+
+  @param  PeiServices   General-purpose services that are available to every PEIM.
+  @param  This          Indicates the EFI_PEI_RECOVERY_MODULE_PPI instance.
+
+  @retval EFI_SUCCESS        The capsule was loaded correctly.
+  @retval EFI_DEVICE_ERROR   A device error occurred.
+  @retval EFI_NOT_FOUND      A recovery DXE capsule cannot be found.
+
+**/
+typedef
+EFI_STATUS
+(EFIAPI *EFI_PEI_LOAD_RECOVERY_CAPSULE)(
+  IN EFI_PEI_SERVICES             **PeiServices,
+  IN EFI_PEI_RECOVERY_MODULE_PPI  *This
+  );
+
+///
+///  Finds and loads the recovery files.
+///
+struct _EFI_PEI_RECOVERY_MODULE_PPI {
+  EFI_PEI_LOAD_RECOVERY_CAPSULE LoadRecoveryCapsule;  ///< Loads a DXE binary capsule into memory.
+};
+
+extern EFI_GUID gEfiPeiRecoveryModulePpiGuid;
+
+#endif