110 lines
4.3 KiB
C
110 lines
4.3 KiB
C
/** @file
|
|
Prototype of SEC Platform hook library.
|
|
|
|
@copyright
|
|
INTEL CONFIDENTIAL
|
|
Copyright 2008 - 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 _SEC_PLATFORM_LIB_H_
|
|
#define _SEC_PLATFORM_LIB_H_
|
|
|
|
#include <Ppi/SecPlatformInformation.h>
|
|
#include <Ppi/SecPerformance.h>
|
|
|
|
/**
|
|
A developer supplied function to perform platform specific operations.
|
|
|
|
It's a developer supplied function to perform any operations appropriate to a
|
|
given platform. It's invoked just before passing control to PEI core by SEC
|
|
core. Platform developer may modify the SecCoreData passed to PEI Core.
|
|
It returns a platform specific PPI list that platform wishes to pass to PEI core.
|
|
The Generic SEC core module will merge this list to join the final list passed to
|
|
PEI core.
|
|
|
|
@param SecCoreData The same parameter as passing to PEI core. It
|
|
could be overridden by this function.
|
|
|
|
@return The platform specific PPI list to be passed to PEI core or
|
|
NULL if there is no need of such platform specific PPI list.
|
|
|
|
**/
|
|
EFI_PEI_PPI_DESCRIPTOR *
|
|
EFIAPI
|
|
SecPlatformMain (
|
|
IN OUT EFI_SEC_PEI_HAND_OFF *SecCoreData
|
|
);
|
|
|
|
|
|
/**
|
|
This interface conveys state information out of the Security (SEC) phase into PEI.
|
|
|
|
@param PeiServices Pointer to the PEI Services Table.
|
|
@param StructureSize Pointer to the variable describing size of the input buffer.
|
|
@param PlatformInformationRecord Pointer to the EFI_SEC_PLATFORM_INFORMATION_RECORD.
|
|
|
|
@retval EFI_SUCCESS The data was successfully returned.
|
|
@retval EFI_BUFFER_TOO_SMALL The buffer was too small.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
SecPlatformInformation (
|
|
IN CONST EFI_PEI_SERVICES **PeiServices,
|
|
IN OUT UINT64 *StructureSize,
|
|
OUT EFI_SEC_PLATFORM_INFORMATION_RECORD *PlatformInformationRecord
|
|
);
|
|
|
|
/**
|
|
This interface conveys performance information out of the Security (SEC) phase into PEI.
|
|
|
|
This service is published by the SEC phase. The SEC phase handoff has an optional
|
|
EFI_PEI_PPI_DESCRIPTOR list as its final argument when control is passed from SEC into the
|
|
PEI Foundation. As such, if the platform supports collecting performance data in SEC,
|
|
this information is encapsulated into the data structure abstracted by this service.
|
|
This information is collected for the boot-strap processor (BSP) on IA-32.
|
|
|
|
@param[in] PeiServices The pointer to the PEI Services Table.
|
|
@param[in] This The pointer to this instance of the PEI_SEC_PERFORMANCE_PPI.
|
|
@param[out] Performance The pointer to performance data collected in SEC phase.
|
|
|
|
@retval EFI_SUCCESS The data was successfully returned.
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
SecGetPerformance (
|
|
IN CONST EFI_PEI_SERVICES **PeiServices,
|
|
IN PEI_SEC_PERFORMANCE_PPI *This,
|
|
OUT FIRMWARE_SEC_PERFORMANCE *Performance
|
|
);
|
|
|
|
#endif
|
|
|