FmpPayloadHeaderLib.h File Reference

Go to the source code of this file.

Functions
EFI_STATUS EFIAPI	GetFmpPayloadHeaderSize (IN CONST VOID *Header, IN CONST UINTN FmpPayloadSize, OUT UINT32 *Size)
EFI_STATUS EFIAPI	GetFmpPayloadHeaderVersion (IN CONST VOID *Header, IN CONST UINTN FmpPayloadSize, OUT UINT32 *Version)
EFI_STATUS EFIAPI	GetFmpPayloadHeaderLowestSupportedVersion (IN CONST VOID *Header, IN CONST UINTN FmpPayloadSize, OUT UINT32 *LowestSupportedVersion)

Detailed Description

Provides services to retrieve values from a capsule's FMP Payload Header. The structure is not included in the library class. Instead, services are provided to retrieve information from the FMP Payload Header. If information is added to the FMP Payload Header, then new services may be added to this library class to retrieve the new information.

Copyright (c) 2016, Microsoft Corporation. All rights reserved.
Copyright (c) 2018, Intel Corporation. All rights reserved.

SPDX-License-Identifier: BSD-2-Clause-Patent

Definition in file FmpPayloadHeaderLib.h.

Function Documentation

GetFmpPayloadHeaderLowestSupportedVersion()

EFI_STATUS EFIAPI GetFmpPayloadHeaderLowestSupportedVersion	(	IN CONST VOID *	Header,
		IN CONST UINTN	FmpPayloadSize,
		OUT UINT32 *	LowestSupportedVersion
	)

Returns the lowest supported version described in the FMP Payload Header.

Parameters

[in]	Header	FMP Payload Header to evaluate
[in]	FmpPayloadSize	Size of FMP payload
[out]	LowestSupportedVersion	The lowest supported version described in the FMP Payload Header.

Return values

EFI_SUCCESS	The lowest support version was returned.
EFI_INVALID_PARAMETER	Header is NULL.
EFI_INVALID_PARAMETER	LowestSupportedVersion is NULL.
EFI_INVALID_PARAMETER	Header is not a valid FMP Payload Header.

Definition at line 146 of file FmpPayloadHeaderLib.c.

GetFmpPayloadHeaderSize()

EFI_STATUS EFIAPI GetFmpPayloadHeaderSize	(	IN CONST VOID *	Header,
		IN CONST UINTN	FmpPayloadSize,
		OUT UINT32 *	Size
	)

Returns the FMP Payload Header size in bytes.

Parameters

[in]	Header	FMP Payload Header to evaluate
[in]	FmpPayloadSize	Size of FMP payload
[out]	Size	The size, in bytes, of the FMP Payload Header.

Return values

EFI_SUCCESS	The firmware version was returned.
EFI_INVALID_PARAMETER	Header is NULL.
EFI_INVALID_PARAMETER	Size is NULL.
EFI_INVALID_PARAMETER	Header is not a valid FMP Payload Header.

Definition at line 54 of file FmpPayloadHeaderLib.c.

GetFmpPayloadHeaderVersion()

EFI_STATUS EFIAPI GetFmpPayloadHeaderVersion	(	IN CONST VOID *	Header,
		IN CONST UINTN	FmpPayloadSize,
		OUT UINT32 *	Version
	)

Returns the version described in the FMP Payload Header.

Parameters

[in]	Header	FMP Payload Header to evaluate
[in]	FmpPayloadSize	Size of FMP payload
[out]	Version	The firmware version described in the FMP Payload Header.

Return values

EFI_SUCCESS	The firmware version was returned.
EFI_INVALID_PARAMETER	Header is NULL.
EFI_INVALID_PARAMETER	Version is NULL.
EFI_INVALID_PARAMETER	Header is not a valid FMP Payload Header.

Definition at line 100 of file FmpPayloadHeaderLib.c.