/** @file | |
Null Dxe Capsule Library instance does nothing and returns unsupport status. | |
Copyright (c) 2007 - 2016, 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 | |
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 <Uefi.h> | |
#include <Library/CapsuleLib.h> | |
/** | |
The firmware checks whether the capsule image is supported | |
by the CapsuleGuid in CapsuleHeader or other specific information in capsule image. | |
Caution: This function may receive untrusted input. | |
@param CapsuleHeader Point to the UEFI capsule image to be checked. | |
@retval EFI_UNSUPPORTED Input capsule is not supported by the firmware. | |
**/ | |
EFI_STATUS | |
EFIAPI | |
SupportCapsuleImage ( | |
IN EFI_CAPSULE_HEADER *CapsuleHeader | |
) | |
{ | |
return EFI_UNSUPPORTED; | |
} | |
/** | |
The firmware specific implementation processes the capsule image | |
if it recognized the format of this capsule image. | |
Caution: This function may receive untrusted input. | |
@param CapsuleHeader Point to the UEFI capsule image to be processed. | |
@retval EFI_UNSUPPORTED Capsule image is not supported by the firmware. | |
**/ | |
EFI_STATUS | |
EFIAPI | |
ProcessCapsuleImage ( | |
IN EFI_CAPSULE_HEADER *CapsuleHeader | |
) | |
{ | |
return EFI_UNSUPPORTED; | |
} | |
/** | |
This routine is called to process capsules. | |
Caution: This function may receive untrusted input. | |
The capsules reported in EFI_HOB_UEFI_CAPSULE are processed. | |
If there is no EFI_HOB_UEFI_CAPSULE, this routine does nothing. | |
This routine should be called twice in BDS. | |
1) The first call must be before EndOfDxe. The system capsules is processed. | |
If device capsule FMP protocols are exposted at this time and device FMP | |
capsule has zero EmbeddedDriverCount, the device capsules are processed. | |
Each individual capsule result is recorded in capsule record variable. | |
System may reset in this function, if reset is required by capsule and | |
all capsules are processed. | |
If not all capsules are processed, reset will be defered to second call. | |
2) The second call must be after EndOfDxe and after ConnectAll, so that all | |
device capsule FMP protocols are exposed. | |
The system capsules are skipped. If the device capsules are NOT processed | |
in first call, they are processed here. | |
Each individual capsule result is recorded in capsule record variable. | |
System may reset in this function, if reset is required by capsule | |
processed in first call and second call. | |
@retval EFI_SUCCESS There is no error when processing capsules. | |
@retval EFI_OUT_OF_RESOURCES No enough resource to process capsules. | |
**/ | |
EFI_STATUS | |
EFIAPI | |
ProcessCapsules ( | |
VOID | |
) | |
{ | |
return EFI_UNSUPPORTED; | |
} | |