132 lines
4.4 KiB
C
132 lines
4.4 KiB
C
/** @file
|
|
The platform boot manager reference implement
|
|
|
|
@copyright
|
|
INTEL CONFIDENTIAL
|
|
Copyright 2004 - 2016 Intel Corporation.
|
|
|
|
The source code contained or described herein and all documents related to the
|
|
source code ("Material") are owned by Intel Corporation or its suppliers or
|
|
licensors. Title to the Material remains with Intel Corporation or its suppliers
|
|
and licensors. The Material may contain trade secrets and proprietary and
|
|
confidential information of Intel Corporation and its suppliers and licensors,
|
|
and is protected by worldwide copyright and trade secret laws and treaty
|
|
provisions. No part of the Material may be used, copied, reproduced, modified,
|
|
published, uploaded, posted, transmitted, distributed, or disclosed in any way
|
|
without Intel's prior express written permission.
|
|
|
|
No license under any patent, copyright, trade secret or other intellectual
|
|
property right is granted to or conferred upon you by disclosure or delivery
|
|
of the Materials, either expressly, by implication, inducement, estoppel or
|
|
otherwise. Any license under such intellectual property rights must be
|
|
express and approved by Intel in writing.
|
|
|
|
Unless otherwise agreed by Intel in writing, you may not remove or alter
|
|
this notice or any other notice embedded in Materials by Intel or
|
|
Intel's suppliers or licensors in any way.
|
|
|
|
This file contains a 'Sample Driver' and is licensed as such under the terms
|
|
of your license agreement with Intel or your vendor. This file may be modified
|
|
by the user, subject to the additional terms of the license agreement.
|
|
|
|
@par Specification Reference:
|
|
**/
|
|
|
|
#ifndef _EFI_BOOT_MANAGER_H_
|
|
#define _EFI_BOOT_MANAGER_H_
|
|
|
|
#include "Ui.h"
|
|
#include "FrontPage.h"
|
|
|
|
//
|
|
// These are defined as the same with vfr file
|
|
//
|
|
#define BOOT_MANAGER_FORMSET_GUID \
|
|
{ \
|
|
0x847bc3fe, 0xb974, 0x446d, {0x94, 0x49, 0x5a, 0xd5, 0x41, 0x2e, 0x99, 0x3b} \
|
|
}
|
|
|
|
#define BOOT_MANAGER_FORM_ID 0x1000
|
|
|
|
#define LABEL_BOOT_OPTION 0x00
|
|
#define LABEL_BOOT_OPTION_END 0x01
|
|
|
|
//
|
|
// These are the VFR compiler generated data representing our VFR data.
|
|
//
|
|
extern UINT8 BootManagerVfrBin[];
|
|
|
|
#define BOOT_MANAGER_CALLBACK_DATA_SIGNATURE SIGNATURE_32 ('B', 'M', 'C', 'B')
|
|
|
|
typedef struct {
|
|
UINTN Signature;
|
|
|
|
//
|
|
// HII relative handles
|
|
//
|
|
EFI_HII_HANDLE HiiHandle;
|
|
EFI_HANDLE DriverHandle;
|
|
|
|
//
|
|
// Produced protocols
|
|
//
|
|
EFI_HII_CONFIG_ACCESS_PROTOCOL ConfigAccess;
|
|
} BOOT_MANAGER_CALLBACK_DATA;
|
|
|
|
/**
|
|
This call back function is registered with Boot Manager formset.
|
|
When user selects a boot option, this call back function will
|
|
be triggered. The boot option is saved for later processing.
|
|
|
|
|
|
@param This Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.
|
|
@param Action Specifies the type of action taken by the browser.
|
|
@param QuestionId A unique value which is sent to the original exporting driver
|
|
so that it can identify the type of data to expect.
|
|
@param Type The type of value for the question.
|
|
@param Value A pointer to the data being sent to the original exporting driver.
|
|
@param ActionRequest On return, points to the action requested by the callback function.
|
|
|
|
@retval EFI_SUCCESS The callback successfully handled the action.
|
|
@retval EFI_INVALID_PARAMETER The setup browser call this function with invalid parameters.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
BootManagerCallback (
|
|
IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL *This,
|
|
IN EFI_BROWSER_ACTION Action,
|
|
IN EFI_QUESTION_ID QuestionId,
|
|
IN UINT8 Type,
|
|
IN EFI_IFR_TYPE_VALUE *Value,
|
|
OUT EFI_BROWSER_ACTION_REQUEST *ActionRequest
|
|
);
|
|
|
|
/**
|
|
|
|
Registers HII packages for the Boot Manger to HII Database.
|
|
It also registers the browser call back function.
|
|
|
|
@retval EFI_SUCCESS HII packages for the Boot Manager were registered successfully.
|
|
@retval EFI_OUT_OF_RESOURCES HII packages for the Boot Manager failed to be registered.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
InitializeBootManager (
|
|
VOID
|
|
);
|
|
|
|
/**
|
|
This function invokes Boot Manager. If all devices have not a chance to be connected,
|
|
the connect all will be triggered. It then enumerate all boot options. If
|
|
a boot option from the Boot Manager page is selected, Boot Manager will boot
|
|
from this boot option.
|
|
|
|
**/
|
|
VOID
|
|
CallBootManager (
|
|
VOID
|
|
);
|
|
|
|
#endif
|