sravan/system76-edk2
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add comments for these header files

Browse Source 
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@7364 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
lgao4
2009-01-23 14:45:13 +00:00
parent 7c9c12f09c
commit 6426c8ffb4
16 changed files with 87 additions and 51 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
MdeModulePkg/Include/Guid/BootState.h
View File

@ -1,5 +1,7 @@
/** @file /** @file
This file defines variable name and variable GUID for boot state. This file defines variable name and variable GUID for boot state.
This variable is to mark if the machine has complete one boot cycle before.
After the complete boot, the variable BootState will be set to 1.
Copyright (c) 2006 - 2008, Intel Corporation. <BR> Copyright (c) 2006 - 2008, Intel Corporation. <BR>
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials

3
MdeModulePkg/Include/Guid/CapsuleVendor.h
View File

@ -1,6 +1,7 @@
/** @file /** @file
This file defines capsule vendor guid for capsule variable and hob. This file defines capsule vendor guid for capsule variable and hob.
It also defines capsule varialbe name and capsule guid hob data structure. It also defines capsule varialbe name and capsule guid hob data structure,
which can be used to store the capsule image start address and length.
They are used by EDKII implementation of capsule update across a system reset. They are used by EDKII implementation of capsule update across a system reset.
Copyright (c) 2006 - 2008, Intel Corporation Copyright (c) 2006 - 2008, Intel Corporation

5
MdeModulePkg/Include/Guid/GenericPlatformVariable.h
View File

@ -1,7 +1,8 @@
/** @file /** @file
This file defines the genenic platform guid for EFI variable. This file defines the genenic platform guid for EFI variable.
Generic drivers can use this guid with its variable name to specify Common drivers without specific requirement
its EFI variable without defining another new guid. can use this guid with their variable name to specify
their EFI variable without defining another new guid.
Copyright (c) 2006 - 2008, Intel Corporation. <BR> Copyright (c) 2006 - 2008, Intel Corporation. <BR>
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials

9
MdeModulePkg/Include/Guid/MemoryTypeInformation.h
View File

@ -1,6 +1,7 @@
/** @file /** @file
This file defines the memory type information guid, variable name and guid hob structure. This file defines the memory type information guid for its variable and guid.
This guid is used for Memory Type Information entries in the HOB list and EFI variable. It also defines memory type info varialbe name and data structure for varialbe and hob both,
which can be used to store the information for each memory type in EFI varialbe or HOB.
Copyright (c) 2006 - 2008, Intel Corporation. <BR> Copyright (c) 2006 - 2008, Intel Corporation. <BR>
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
@ -24,8 +25,8 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
extern EFI_GUID gEfiMemoryTypeInformationGuid; extern EFI_GUID gEfiMemoryTypeInformationGuid;
typedef struct { typedef struct {
UINT32 Type; /// EFI memory type defined in UEFI specification. UINT32 Type; ///> EFI memory type defined in UEFI specification.
UINT32 NumberOfPages; /// The pages of this type memory. UINT32 NumberOfPages; ///> The pages of this type memory.
} EFI_MEMORY_TYPE_INFORMATION; } EFI_MEMORY_TYPE_INFORMATION;
#endif #endif

32
MdeModulePkg/Include/Guid/OverrideVariable.h
View File

@ -1,7 +1,37 @@
/** @file /** @file
This file defines the platform driver override variable name and variable guid. This file defines the platform driver override variable name and variable guid.
The variable(s) contain the override mappings from Controller Device Path to a set of Driver Device Paths.
Copyright (c) 2008, Intel Corporation VariableLayout {
//
// NotEnd indicate whether the variable is the last one, and has no subsequent variable need to load.
// Each variable has MaximumVariableSize limitation, so multiple variables are required to store
// large mapping infos.
// The variable(s) name rule is PlatDriOver, PlatDriOver1, PlatDriOver2, ....
//
UINT32 NotEnd; //Zero is the last one.
//
// The entry which contains the mapping that Controller Device Path to a set of Driver Device Paths
// There are often multi mapping entries in a variable.
//
UINT32 SIGNATURE; //SIGNATURE_32('p','d','o','i')
UINT32 DriverNum;
EFI_DEVICE_PATH_PROTOCOL ControllerDevicePath[];
EFI_DEVICE_PATH_PROTOCOL DriverDevicePath[];
EFI_DEVICE_PATH_PROTOCOL DriverDevicePath[];
EFI_DEVICE_PATH_PROTOCOL DriverDevicePath[];
......
UINT32 NotEnd; //Zero is the last one.
UINT32 SIGNATURE;
UINT32 DriverNum;
EFI_DEVICE_PATH_PROTOCOL ControllerDevicePath[];
EFI_DEVICE_PATH_PROTOCOL DriverDevicePath[];
EFI_DEVICE_PATH_PROTOCOL DriverDevicePath[];
EFI_DEVICE_PATH_PROTOCOL DriverDevicePath[];
......
}
Copyright (c) 2008 - 2009, Intel Corporation
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License are licensed and made available under the terms and conditions of the BSD License
which accompanies this distribution. The full text of the license may be found at which accompanies this distribution. The full text of the license may be found at

4
MdeModulePkg/Include/Guid/PeiPeCoffLoader.h
View File

@ -2,7 +2,7 @@
This file defines PeCoffLoader guid for PeCoffLoader entry in the HOB list. This file defines PeCoffLoader guid for PeCoffLoader entry in the HOB list.
It also defines PE/COFF Loader APIs in PeCoffLoader Hob entry shared between SEC, PEI and DXE It also defines PE/COFF Loader APIs in PeCoffLoader Hob entry shared between SEC, PEI and DXE
Copyright (c) 2006 - 2008, Intel Corporation Copyright (c) 2006 - 2009, Intel Corporation
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License are licensed and made available under the terms and conditions of the BSD License
which accompanies this distribution. The full text of the license may be found at which accompanies this distribution. The full text of the license may be found at
@ -17,7 +17,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
#define __PEI_PE_COFF_LOADER_H__ #define __PEI_PE_COFF_LOADER_H__
// //
// MdePkg/Include/Common/PeCoffLoaderImageContext.h // Depend on PE_COFF_LOADER_IMAGE_CONTEXT structure definition in PeCoff library class.
// //
#include <Library/PeCoffLib.h> #include <Library/PeCoffLib.h>

13
MdeModulePkg/Include/Guid/PeiPerformanceHob.h
View File

@ -1,8 +1,9 @@
/** @file /** @file
This file defines performance guid for the performance entry in the HOB list, This file defines performance guid for the performance entry in the HOB list,
and define the PEI Performance HOB data structures. and define the PEI Performance HOB data structures.
This hob can be used to store the boot performance data of pei phase.
Copyright (c) 2006 - 2008, Intel Corporation. <BR> Copyright (c) 2006 - 2009, Intel Corporation. <BR>
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License are licensed and made available under the terms and conditions of the BSD License
which accompanies this distribution. The full text of the license may be found at which accompanies this distribution. The full text of the license may be found at
@ -30,17 +31,17 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
typedef struct { typedef struct {
EFI_PHYSICAL_ADDRESS Handle; EFI_PHYSICAL_ADDRESS Handle;
CHAR8 Token[PEI_PERFORMANCE_STRING_SIZE]; /// Measured token string name CHAR8 Token[PEI_PERFORMANCE_STRING_SIZE]; ///> Measured token string name
CHAR8 Module[PEI_PERFORMANCE_STRING_SIZE]; /// Module string name CHAR8 Module[PEI_PERFORMANCE_STRING_SIZE]; ///> Module string name
UINT64 StartTimeStamp; /// Start time point UINT64 StartTimeStamp; ///> Start time point
UINT64 EndTimeStamp; /// End time point UINT64 EndTimeStamp; ///> End time point
} PEI_PERFORMANCE_LOG_ENTRY; } PEI_PERFORMANCE_LOG_ENTRY;
// //
// The header must be aligned at 8 bytes. // The header must be aligned at 8 bytes.
// //
typedef struct { typedef struct {
UINT32 NumberOfEntries; /// The number of all performance log entries UINT32 NumberOfEntries; ///> The number of all performance log entries
UINT32 Reserved; UINT32 Reserved;
} PEI_PERFORMANCE_LOG_HEADER; } PEI_PERFORMANCE_LOG_HEADER;

4
MdeModulePkg/Include/Guid/PrimaryConsoleInDevice.h
View File

@ -1,8 +1,8 @@
/** @file /** @file
This guid is used to specify the primary console in device. This guid is used to specify the primary console in device.
It will be installed into the virtual device handle for ConIn Splitter. It will be installed as the protocol guid into the virtual device handle for ConIn Splitter.
Copyright (c) 2006 - 2008, Intel Corporation Copyright (c) 2006 - 2009, Intel Corporation
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License are licensed and made available under the terms and conditions of the BSD License
which accompanies this distribution. The full text of the license may be found at which accompanies this distribution. The full text of the license may be found at

4
MdeModulePkg/Include/Guid/PrimaryConsoleOutDevice.h
View File

@ -1,8 +1,8 @@
/** @file /** @file
This guid is used to specify the primary console out device. This guid is used to specify the primary console out device.
It will be installed into the virtual device handle for ConOut Splitter. It will be installed as the protocol guid into the virtual device handle for ConOut Splitter.
Copyright (c) 2006 - 2008, Intel Corporation Copyright (c) 2006 - 2009, Intel Corporation
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License are licensed and made available under the terms and conditions of the BSD License
which accompanies this distribution. The full text of the license may be found at which accompanies this distribution. The full text of the license may be found at

4
MdeModulePkg/Include/Guid/PrimaryStandardErrorDevice.h
View File

@ -1,8 +1,8 @@
/** @file /** @file
This guid is used to specify the primary StdErr device. This guid is used to specify the primary StdErr device.
It will be installed into the virtual device handle for StdErr Splitter. It will be installed as the protocol guid into the virtual device handle for StdErr Splitter.
Copyright (c) 2006 - 2008, Intel Corporation Copyright (c) 2006 - 2009, Intel Corporation
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License are licensed and made available under the terms and conditions of the BSD License
which accompanies this distribution. The full text of the license may be found at which accompanies this distribution. The full text of the license may be found at

2
MdeModulePkg/Include/Guid/ShellFile.h
View File

@ -1,5 +1,5 @@
/** @file /** @file
This file defines FFS GUID Filename for EFI Shell. This file defines File GUID for EFI Shell.
Copyright (c) 2006 - 2008, Intel Corporation. <BR> Copyright (c) 2006 - 2008, Intel Corporation. <BR>
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials

14
MdeModulePkg/Include/Guid/SystemNvDataGuid.h
View File

@ -1,11 +1,15 @@
/** @file /** @file
This file defines NvData Hob GUIDs for System Non Volatile HOB entries and the corresponding hob data structure. This file defines NvData Hob GUIDs for System Non Volatile HOB entries
NvData Hob is used to report the region of the system non volatile data and the corresponding hob data structure. NvData Hob can be used to report
for the specific purpose, such as FTW region, Error log region. the region of the system non volatile data for the specific purpose,
such as FTW region, Error log region.
It also defines NvDataFv GUID used as the signature of FTW working block header. It also defines NvDataFv GUID.
This guid can be used as FileSystemGuid in EFI_FIRMWARE_VOLUME_HEADER if
this FV image contains NV data, such as NV variable data.
This guid can also be used as the signature of FTW working block header.
Copyright (c) 2006 - 2008, Intel Corporation Copyright (c) 2006 - 2009, Intel Corporation
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License are licensed and made available under the terms and conditions of the BSD License
which accompanies this distribution. The full text of the license may be found at which accompanies this distribution. The full text of the license may be found at

29
MdeModulePkg/Include/Guid/VariableInfo.h
View File

@ -1,7 +1,8 @@
/** @file /** @file
This file defines GUIDs used for variable list entries put in the EFI system table. This file defines variable info guid and variable info entry.
This guid is used to specify the variable list put in the EFI system table.
Copyright (c) 2006 - 2008, Intel Corporation Copyright (c) 2006 - 2009, Intel Corporation
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License are licensed and made available under the terms and conditions of the BSD License
which accompanies this distribution. The full text of the license may be found at which accompanies this distribution. The full text of the license may be found at
@ -15,7 +16,6 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
#ifndef __VARIABLE_INFO_GUID_H__ #ifndef __VARIABLE_INFO_GUID_H__
#define __VARIABLE_INFO_GUID_H__ #define __VARIABLE_INFO_GUID_H__
// {DDCF3616-3275-4164-98B6-FE85707FFE7D}
#define EFI_VARIABLE_INFO_GUID \ #define EFI_VARIABLE_INFO_GUID \
{ 0xddcf3616, 0x3275, 0x4164, { 0x98, 0xb6, 0xfe, 0x85, 0x70, 0x7f, 0xfe, 0x7d } } { 0xddcf3616, 0x3275, 0x4164, { 0x98, 0xb6, 0xfe, 0x85, 0x70, 0x7f, 0xfe, 0x7d } }
@ -25,19 +25,20 @@ extern EFI_GUID gEfiVariableInfoGuid;
typedef struct _VARIABLE_INFO_ENTRY VARIABLE_INFO_ENTRY; typedef struct _VARIABLE_INFO_ENTRY VARIABLE_INFO_ENTRY;
/// ///
/// This list gets put in the EFI system table. It is produced by the Variable driver at /// This structure contains the variable list that is put in EFI system table.
/// Boot Services time and records read and write access to a given variable /// The variable driver collects all used variables at boot service time and produce this list.
/// This is an optional feature to dump all used variables in shell environment.
/// ///
struct _VARIABLE_INFO_ENTRY { struct _VARIABLE_INFO_ENTRY {
VARIABLE_INFO_ENTRY *Next; /// Pointer to next entry VARIABLE_INFO_ENTRY *Next; ///> Pointer to next entry
EFI_GUID VendorGuid; /// Guid of Variable EFI_GUID VendorGuid; ///> Guid of Variable
CHAR16 *Name; /// Name of Variable CHAR16 *Name; ///> Name of Variable
UINT32 Attributes; /// Attributes of variable defined in UEFI spec UINT32 Attributes; ///> Attributes of variable defined in UEFI spec
UINT32 ReadCount; /// Times to read this variable UINT32 ReadCount; ///> Times to read this variable
UINT32 WriteCount; /// Times to write this variable UINT32 WriteCount; ///> Times to write this variable
UINT32 DeleteCount; /// Times to delete this variable UINT32 DeleteCount; ///> Times to delete this variable
UINT32 CacheCount; /// Times that cache hits this variable UINT32 CacheCount; ///> Times that cache hits this variable
BOOLEAN Volatile; /// TRUE if volatile FALSE if non-volatile BOOLEAN Volatile; ///> TRUE if volatile FALSE if non-volatile
}; };
#endif #endif

4
MdeModulePkg/Include/Ppi/FlashMap.h
View File

@ -23,9 +23,6 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
typedef struct _PEI_FLASH_MAP_PPI PEI_FLASH_MAP_PPI; typedef struct _PEI_FLASH_MAP_PPI PEI_FLASH_MAP_PPI;
//
// Functions
//
/** /**
Get flash region information. Get flash region information.
@ -50,7 +47,6 @@ EFI_STATUS
OUT EFI_FLASH_SUBAREA_ENTRY **Entries OUT EFI_FLASH_SUBAREA_ENTRY **Entries
); );
struct _PEI_FLASH_MAP_PPI { struct _PEI_FLASH_MAP_PPI {
PEI_GET_FLASH_AREA_INFO GetAreaInfo; PEI_GET_FLASH_AREA_INFO GetAreaInfo;
}; };

2
MdeModulePkg/Include/Ppi/OperatorPresence.h
View File

@ -21,7 +21,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
typedef struct _PEI_OPERATOR_PRESENCE_PPI PEI_OPERATOR_PRESENCE_PPI; typedef struct _PEI_OPERATOR_PRESENCE_PPI PEI_OPERATOR_PRESENCE_PPI;
struct _PEI_OPERATOR_PRESENCE_PPI { struct _PEI_OPERATOR_PRESENCE_PPI {
BOOLEAN OperatorPresent; /// TRUE if TPM Operator is detected. BOOLEAN OperatorPresent; ///> TRUE if TPM Operator is detected.
}; };
extern EFI_GUID gPeiOperatorPresencePpiGuid; extern EFI_GUID gPeiOperatorPresencePpiGuid;

5
MdeModulePkg/Library/DxePlatDriOverLib/PlatDriOverLib.c
View File

@ -206,7 +206,7 @@ InitOverridesMapping (
VariableIndex += ((sizeof(UINT32) - ((UINTN) (VariableIndex))) & (sizeof(UINT32) - 1)); VariableIndex += ((sizeof(UINT32) - ((UINTN) (VariableIndex))) & (sizeof(UINT32) - 1));
// //
// Get all DriverDevicePath[] // Get all DriverImageDevicePath[]
// //
for (Index = 0; Index < DriverNumber; Index++) { for (Index = 0; Index < DriverNumber; Index++) {
// //
@ -240,10 +240,9 @@ InitOverridesMapping (
// NotEnd indicates whether current variable is the end variable. // NotEnd indicates whether current variable is the end variable.
// //
if (NotEnd != 0) { if (NotEnd != 0) {
UnicodeSPrint (OverrideVariableName, sizeof (OverrideVariableName), L"PlatDriOver%d", VariableNum); UnicodeSPrint (OverrideVariableName, sizeof (OverrideVariableName), L"PlatDriOver%d", VariableNum++);
VariableBuffer = GetVariableAndSize (OverrideVariableName, &gEfiOverrideVariableGuid, &BufferSize); VariableBuffer = GetVariableAndSize (OverrideVariableName, &gEfiOverrideVariableGuid, &BufferSize);
ASSERT ((UINTN) VariableBuffer % sizeof(UINTN) == 0); ASSERT ((UINTN) VariableBuffer % sizeof(UINTN) == 0);
VariableNum++;
if (VariableBuffer == NULL) { if (VariableBuffer == NULL) {
FreeMappingDatabase (MappingDataBase); FreeMappingDatabase (MappingDataBase);
return EFI_VOLUME_CORRUPTED; return EFI_VOLUME_CORRUPTED;