IntelFrameworkModulePkg/DxeCapsuleLib: Add ProcessCapsules().
authorJiewen Yao <>
Wed, 21 Sep 2016 01:59:17 +0000 (09:59 +0800)
committerJiewen Yao <>
Tue, 8 Nov 2016 14:37:12 +0000 (22:37 +0800)
Add NULL ProcessCapsules() interface for DxeCapsuleLib.
IntelFrameworkModulePkg is under maintenance phase.
We stop adding new feature there.
Just add NULL function to make it pass build.

Cc: Jeff Fan <>
Cc: Feng Tian <>
Cc: Star Zeng <>
Cc: Michael D Kinney <>
Cc: Liming Gao <>
Cc: Chao Zhang <>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jiewen Yao <>
Reviewed-by: Jeff Fan <>
Reviewed-by: Michael Kinney <>
Tested-by: Michael Kinney <>

index fc9b533f2ce22ed1bbb848f12ae297d41fde35de..eaed06e0120f28aeaa1df89b620d4032902cadbc 100644 (file)
@@ -1,7 +1,7 @@
 /** @file\r
   Capsule Library instance to process capsule images.\r
-  Copyright (c) 2007 - 2013, Intel Corporation. All rights reserved.<BR>\r
+  Copyright (c) 2007 - 2016, Intel Corporation. All rights reserved.<BR>\r
   This program and the accompanying materials\r
   are licensed and made available under the terms and conditions of the BSD License\r
@@ -515,4 +515,42 @@ ProcessCapsuleImage (
   return Status;\r
+  This routine is called to process capsules.\r
+  Caution: This function may receive untrusted input.\r
+  The capsules reported in EFI_HOB_UEFI_CAPSULE are processed.\r
+  If there is no EFI_HOB_UEFI_CAPSULE, this routine does nothing.\r
+  This routine should be called twice in BDS.\r
+  1) The first call must be before EndOfDxe. The system capsules is processed.\r
+     If device capsule FMP protocols are exposted at this time and device FMP\r
+     capsule has zero EmbeddedDriverCount, the device capsules are processed.\r
+     Each individual capsule result is recorded in capsule record variable.\r
+     System may reset in this function, if reset is required by capsule and\r
+     all capsules are processed.\r
+     If not all capsules are processed, reset will be defered to second call.\r
+  2) The second call must be after EndOfDxe and after ConnectAll, so that all\r
+     device capsule FMP protocols are exposed.\r
+     The system capsules are skipped. If the device capsules are NOT processed\r
+     in first call, they are processed here.\r
+     Each individual capsule result is recorded in capsule record variable.\r
+     System may reset in this function, if reset is required by capsule\r
+     processed in first call and second call.\r
+  @retval EFI_SUCCESS             There is no error when processing capsules.\r
+  @retval EFI_OUT_OF_RESOURCES    No enough resource to process capsules.\r
+ProcessCapsules (\r
+  VOID\r
+  )\r
+  return EFI_UNSUPPORTED;\r