mirror of
https://github.com/acidanthera/audk.git
synced 2025-05-18 05:20:10 +02:00
878b807a43
https://bugzilla.tianocore.org/show_bug.cgi?id=1373 Replace BSD 2-Clause License with BSD+Patent License. This change is based on the following emails: https://lists.01.org/pipermail/edk2-devel/2019-February/036260.html https://lists.01.org/pipermail/edk2-devel/2018-October/030385.html RFCs with detailed process for the license change: V3: https://lists.01.org/pipermail/edk2-devel/2019-March/038116.html V2: https://lists.01.org/pipermail/edk2-devel/2019-March/037669.html V1: https://lists.01.org/pipermail/edk2-devel/2019-March/037500.html Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com> Reviewed-by: Leif Lindholm <leif.lindholm@linaro.org>
81 lines
3.1 KiB
C
81 lines
3.1 KiB
C
/** @file
|
|
|
|
Copyright (c) 2018, Linaro. All rights reserved.<BR>
|
|
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#ifndef __PLATFORM_BOOT_MANAGER_PROTOCOL_H__
|
|
#define __PLATFORM_BOOT_MANAGER_PROTOCOL_H__
|
|
|
|
//
|
|
// Protocol interface structure
|
|
//
|
|
typedef struct _PLATFORM_BOOT_MANAGER_PROTOCOL PLATFORM_BOOT_MANAGER_PROTOCOL;
|
|
|
|
//
|
|
// Function Prototypes
|
|
//
|
|
|
|
/*
|
|
Get predefined boot options for platform.
|
|
|
|
@param[out] Count The number of elements in each of
|
|
BootOptions and BootKeys. On successful
|
|
return, Count is at least one.
|
|
|
|
@param[out] BootOptions An array of platform boot options.
|
|
BootOptions is pool-allocated by
|
|
GET_PLATFORM_BOOT_OPTIONS_AND_KEYS, and
|
|
GET_PLATFORM_BOOT_OPTIONS_AND_KEYS populates
|
|
every element in BootOptions with
|
|
EfiBootManagerInitializeLoadOption().
|
|
BootOptions shall not contain duplicate
|
|
entries. The caller is responsible for
|
|
releasing BootOptions after use with
|
|
EfiBootManagerFreeLoadOptions().
|
|
|
|
@param[out] BootKeys A pool-allocated array of platform boot
|
|
hotkeys. For every 0 <= Index < Count, if
|
|
BootOptions[Index] is not to be associated
|
|
with a hotkey, then BootKeys[Index] is
|
|
zero-filled. Otherwise, BootKeys[Index]
|
|
specifies the boot hotkey for
|
|
BootOptions[Index]. BootKeys shall not
|
|
contain duplicate entries (other than
|
|
zero-filled entries). The caller is
|
|
responsible for releasing BootKeys with
|
|
FreePool() after use.
|
|
|
|
@retval EFI_SUCCESS Count, BootOptions and BootKeys have
|
|
been set.
|
|
|
|
@retval EFI_OUT_OF_RESOURCES Memory allocation failed.
|
|
|
|
@retval EFI_UNSUPPORTED The platform doesn't provide boot options
|
|
as a feature.
|
|
|
|
@retval EFI_NOT_FOUND The platform could provide boot options
|
|
as a feature, but none have been
|
|
configured.
|
|
|
|
@return Error codes propagated from underlying
|
|
functions.
|
|
*/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *GET_PLATFORM_BOOT_OPTIONS_AND_KEYS) (
|
|
OUT UINTN *Count,
|
|
OUT EFI_BOOT_MANAGER_LOAD_OPTION **BootOptions,
|
|
OUT EFI_INPUT_KEY **BootKeys
|
|
);
|
|
|
|
struct _PLATFORM_BOOT_MANAGER_PROTOCOL {
|
|
GET_PLATFORM_BOOT_OPTIONS_AND_KEYS GetPlatformBootOptionsAndKeys;
|
|
};
|
|
|
|
extern EFI_GUID gPlatformBootManagerProtocolGuid;
|
|
|
|
#endif /* __PLATFORM_BOOT_MANAGER_PROTOCOL_H__ */
|