projects / mirror_edk2.git / blame
| Commit | Line | Data |
|---|---|---|
| a39d5097 MK |
1 | /** @file\r |
| 2 | This library class defines interface for platform to perform platform\r | |
| 3 | specific initialization in SEC phase.\r | |
| 4 | \r | |
| 5 | Copyright (c) 2013 - 2015, Intel Corporation. All rights reserved.<BR>\r | |
| 6 | This program and the accompanying materials\r | |
| 7 | are licensed and made available under the terms and conditions of the BSD License\r | |
| 8 | which accompanies this distribution. The full text of the license may be found at\r | |
| 9 | http://opensource.org/licenses/bsd-license.php\r | |
| 10 | \r | |
| 11 | THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r | |
| 12 | WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r | |
| 13 | \r | |
| 14 | **/\r | |
| 15 | \r | |
| 16 | #ifndef __PLATFORM_SEC_LIB_H__\r | |
| 17 | #define __PLATFORM_SEC_LIB_H__\r | |
| 18 | \r | |
| 19 | /**\r | |
| 20 | A developer supplied function to perform platform specific operations.\r | |
| 21 | \r | |
| 22 | It's a developer supplied function to perform any operations appropriate to a\r | |
| 23 | given platform. It's invoked just before passing control to PEI core by SEC\r | |
| 24 | core. Platform developer may modify the SecCoreData passed to PEI Core.\r | |
| 25 | It returns a platform specific PPI list that platform wishes to pass to PEI core.\r | |
| 26 | The Generic SEC core module will merge this list to join the final list passed to\r | |
| 27 | PEI core.\r | |
| 28 | \r | |
| 29 | @param SecCoreData The same parameter as passing to PEI core. It\r | |
| 30 | could be overridden by this function.\r | |
| 31 | \r | |
| 32 | @return The platform specific PPI list to be passed to PEI core or\r | |
| 33 | NULL if there is no need of such platform specific PPI list.\r | |
| 34 | \r | |
| 35 | **/\r | |
| 36 | EFI_PEI_PPI_DESCRIPTOR *\r | |
| 37 | EFIAPI\r | |
| 38 | SecPlatformMain (\r | |
| 39 | IN OUT EFI_SEC_PEI_HAND_OFF *SecCoreData\r | |
| 40 | );\r | |
| 41 | \r | |
| 42 | /**\r | |
| 43 | This interface conveys state information out of the Security (SEC) phase into PEI.\r | |
| 44 | \r | |
| 45 | @param PeiServices Pointer to the PEI Services Table.\r | |
| 46 | @param StructureSize Pointer to the variable describing size of the input buffer.\r | |
| 47 | @param PlatformInformationRecord Pointer to the EFI_SEC_PLATFORM_INFORMATION_RECORD.\r | |
| 48 | \r | |
| 49 | @retval EFI_SUCCESS The data was successfully returned.\r | |
| 50 | @retval EFI_BUFFER_TOO_SMALL The buffer was too small.\r | |
| 51 | \r | |
| 52 | **/\r | |
| 53 | EFI_STATUS\r | |
| 54 | EFIAPI\r | |
| 55 | SecPlatformInformation (\r | |
| 56 | IN CONST EFI_PEI_SERVICES **PeiServices,\r | |
| 57 | IN OUT UINT64 *StructureSize,\r | |
| 58 | OUT EFI_SEC_PLATFORM_INFORMATION_RECORD *PlatformInformationRecord\r | |
| 59 | );\r | |
| 60 | \r | |
| 61 | /**\r | |
| 62 | This interface disables temporary memory in SEC Phase.\r | |
| 63 | **/\r | |
| 64 | VOID\r | |
| 65 | EFIAPI\r | |
| 66 | SecPlatformDisableTemporaryMemory (\r | |
| 67 | VOID\r | |
| 68 | );\r | |
| 69 | \r | |
| 70 | #endif\r |