-/* @file\r
- If a GUID-defined section is encountered when doing section extraction, \r
- the PEI Foundation or the EFI_PEI_FILE_LOADER_PPI instance \r
- calls the appropriate instance of the GUIDed Section Extraction PPI \r
- to extract the section stream contained therein.. \r
+/** @file\r
+ If a GUID-defined section is encountered when doing section extraction,\r
+ the PEI Foundation or the EFI_PEI_FILE_LOADER_PPI instance\r
+ calls the appropriate instance of the GUIDed Section Extraction PPI\r
+ to extract the section stream contained therein.\r
\r
- Copyright (c) 2006 - 2007, Intel Corporation \r
- All rights reserved. This program and the accompanying materials \r
- are licensed and made available under the terms and conditions of the BSD License \r
- which accompanies this distribution. The full text of the license may be found at \r
- http://opensource.org/licenses/bsd-license.php \r
+ Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>\r
+ This program and the accompanying materials\r
+ are licensed and made available under the terms and conditions of the BSD License\r
+ which accompanies this distribution. The full text of the license may be found at\r
+ http://opensource.org/licenses/bsd-license.php\r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
@par Revision Reference:\r
- This PPI is defined in PI Version 1.00.\r
+ This PPI is introduced in PI Version 1.0.\r
\r
**/\r
\r
#define __EFI_GUIDED_SECTION_EXTRACTION_PPI_H__\r
\r
//\r
-// Typically, protocol interface structures are identified \r
-// by associating them with a GUID. Each instance of \r
-// a protocol with a given GUID must have \r
-// the same interface structure. While all instances of \r
-// the GUIDed Section Extraction PPI must have \r
-// the same interface structure, they do not all have \r
-// te same GUID. The GUID that is associated with \r
-// an instance of the GUIDed Section Extraction Protocol \r
-// is used to correlate it with the GUIDed section type \r
+// Typically, protocol interface structures are identified\r
+// by associating them with a GUID. Each instance of\r
+// a protocol with a given GUID must have\r
+// the same interface structure. While all instances of\r
+// the GUIDed Section Extraction PPI must have\r
+// the same interface structure, they do not all have\r
+// te same GUID. The GUID that is associated with\r
+// an instance of the GUIDed Section Extraction Protocol\r
+// is used to correlate it with the GUIDed section type\r
// that it is intended to process.\r
//\r
\r
\r
typedef struct _EFI_PEI_GUIDED_SECTION_EXTRACTION_PPI EFI_PEI_GUIDED_SECTION_EXTRACTION_PPI;\r
\r
-//\r
-// Bit values for AuthenticationStatus\r
-//\r
-#define EFI_AUTH_STATUS_PLATFORM_OVERRIDE 0x01\r
-#define EFI_AUTH_STATUS_IMAGE_SIGNED 0x02\r
-#define EFI_AUTH_STATUS_NOT_TESTED 0x04\r
-#define EFI_AUTH_STATUS_TEST_FAILED 0x08\r
\r
/**\r
+ Processes the input section and returns the data contained therein\r
+ along with the authentication status.\r
+\r
The ExtractSection() function processes the input section and\r
returns a pointer to the section contents. If the section being\r
extracted does not require processing (if the section\r
section's contents. Otherwise, *Buffer must be allocated\r
from PEI permanent memory.\r
\r
- @param This Indicates the\r
- EFI_PEI_GUIDED_SECTION_EXTRACTION_PPI instance.\r
- Buffer containing the input GUIDed section to be\r
- processed. OutputBuffer OutputBuffer is\r
- allocated from PEI permanent memory and contains\r
- the new section stream.\r
- \r
- @param OutputSize A pointer to a caller-allocated\r
- UINTN in which the size of *OutputBuffer\r
- allocation is stored. If the function\r
- returns anything other than EFI_SUCCESS,\r
- the value of OutputSize is undefined.\r
- \r
- @param AuthenticationStatus A pointer to a caller-allocated\r
- UINT32 that indicates the\r
- authentication status of the\r
- output buffer. If the input\r
- section's GuidedSectionHeader.\r
- Attributes field has the\r
- EFI_GUIDED_SECTION_AUTH_STATUS_VALID \r
- bit as clear,\r
- AuthenticationStatus must return\r
- zero. These bits reflect the\r
- status of the extraction\r
- operation. If the function\r
- returns anything other than\r
- EFI_SUCCESS, the value of\r
- AuthenticationStatus is\r
- undefined.\r
- \r
- @retval EFI_SUCCESS The InputSection was\r
- successfully processed and the\r
+ @param This Indicates the EFI_PEI_GUIDED_SECTION_EXTRACTION_PPI\r
+ instance.\r
+ @param InputSection Buffer containing the input GUIDed section to be\r
+ processed.\r
+ @param OutputBuffer *OutputBuffer is allocated from PEI permanent memory\r
+ and contains the new section stream.\r
+ @param OutputSize A pointer to a caller-allocated UINTN in which\r
+ the size of *OutputBuffer allocation is stored.\r
+ If the function returns anything other than\r
+ EFI_SUCCESS, the value of *OutputSize is undefined.\r
+ @param AuthenticationStatus A pointer to a caller-allocated UINT32 that indicates\r
+ the authentication status of the output buffer.\r
+ If the input section's\r
+ GuidedSectionHeader.Attributes field has the\r
+ EFI_GUIDED_SECTION_AUTH_STATUS_VALID bit as clear,\r
+ *AuthenticationStatus must return zero. These bits\r
+ reflect the status of the extraction operation.\r
+ If the function returns anything other than EFI_SUCCESS,\r
+ the value of *AuthenticationStatus is undefined.\r
+\r
+ @retval EFI_SUCCESS The InputSection was successfully processed and the\r
section contents were returned.\r
- \r
- @retval EFI_OUT_OF_RESOURCES The system has insufficient\r
- resources to process the request.\r
- \r
- @reteval EFI_INVALID_PARAMETER The GUID in InputSection does\r
- not match this instance of the\r
+ @retval EFI_OUT_OF_RESOURCES The system has insufficient resources to process the request.\r
+ @retval EFI_INVALID_PARAMETER The GUID in InputSection does not match this instance of the\r
GUIDed Section Extraction PPI.\r
**/\r
typedef\r
EFI_STATUS\r
(EFIAPI *EFI_PEI_EXTRACT_GUIDED_SECTION)(\r
- IN CONST EFI_PEI_GUIDED_SECTION_EXTRACTION_PPI *This,\r
- IN CONST VOID *InputSection,\r
- OUT VOID **OutputBuffer,\r
- OUT UINTN *OutputSize,\r
- OUT UINT32 *AuthenticationStatus\r
+ IN CONST EFI_PEI_GUIDED_SECTION_EXTRACTION_PPI *This,\r
+ IN CONST VOID *InputSection,\r
+ OUT VOID **OutputBuffer,\r
+ OUT UINTN *OutputSize,\r
+ OUT UINT32 *AuthenticationStatus\r
);\r
\r
-\r
-\r
-/**\r
- If a GUID-defined section is encountered when doing section extraction,\r
- the PEI Foundation or the EFI_PEI_FILE_LOADER_PPI instance\r
- calls the appropriate instance of the GUIDed Section\r
- Extraction PPI to extract the section stream contained\r
- therein.\r
- \r
- \r
- @param ExtractSection Takes the GUIDed section as input and\r
- produces the section stream data. See\r
- the ExtractSection() function\r
- description.\r
- \r
-**/\r
+///\r
+/// If a GUID-defined section is encountered when doing section extraction,\r
+/// the PEI Foundation or the EFI_PEI_FILE_LOADER_PPI instance\r
+/// calls the appropriate instance of the GUIDed Section\r
+/// Extraction PPI to extract the section stream contained\r
+/// therein.\r
+///\r
struct _EFI_PEI_GUIDED_SECTION_EXTRACTION_PPI {\r
EFI_PEI_EXTRACT_GUIDED_SECTION ExtractSection;\r
};\r