Code Clean for Driver PlatformDriOverrideDxe and PlatOverMngr application. And Clean PlatDriOver library class.

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@7121 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
lgao4
2008-12-25 09:13:53 +00:00
parent 97404058f1
commit 68dbca6c14
18 changed files with 594 additions and 933 deletions

View File

@@ -1,7 +1,8 @@
/** @file
This file defines the Alternate Firmware Volume Block Guid, which is
used to specify that the additional FVB protocol is installed into FVB handle.
used to specify that the full funcationality FVB protocol is installed
that support read, write and erase capability for block devices.
Copyright (c) 2006 - 2008, Intel Corporation
All rights reserved. This program and the accompanying materials

View File

@@ -1,5 +1,5 @@
/** @file
This file defines the platform override variable name and variable guid.
This file defines the platform driver override variable name and variable guid.
Copyright (c) 2008, Intel Corporation
All rights reserved. This program and the accompanying materials
@@ -25,5 +25,4 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
extern EFI_GUID gEfiOverrideVariableGuid;
#endif // #ifndef __EFI_OVERRIDE_VARIABLE_GUID_H__

View File

@@ -1,6 +1,8 @@
/** @file
This file defines NvDataHob GUIDs for System Non Volatile HOB entries
in the HOB list and NV system hob entry structure.
This file defines NvData Hob GUIDs for System Non Volatile HOB entries and the corresponding hob data structure.
NvData Hob is used to report 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.
Copyright (c) 2006 - 2008, Intel Corporation
@@ -27,13 +29,13 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
/// Hob entry for NV data region
///
typedef struct {
EFI_GUID SystemNvDataHobGuid; /// EFI_SYSTEM_NV_DATA_HOB_GUID
EFI_GUID SystemNvDataFvGuid; /// Guid specifies the NvData Fv for the specific purpose, such as FTW, Error Log.
EFI_LBA StartLba; /// The starting logical block index.
UINTN StartLbaOffset; /// Offset into the starting block at which to the start of NvData region.
EFI_LBA EndLba; /// The last logical block index.
UINTN EndLbaOffset; /// Offset into the last block at which to the end of Nvdata region.
UINT32 DataTypeSignature; /// NvData type in the specified NV range.
EFI_GUID SystemNvDataHobGuid; ///> EFI_SYSTEM_NV_DATA_HOB_GUID
EFI_GUID SystemNvDataFvGuid; ///> Guid specifies the NvData Fv for the specific purpose, such as FTW, Error Log.
EFI_LBA StartLba; ///> The starting logical block index.
UINTN StartLbaOffset; ///> Offset into the starting block at which to the start of NvData region.
EFI_LBA EndLba; ///> The last logical block index.
UINTN EndLbaOffset; ///> Offset into the last block at which to the end of Nvdata region.
UINT32 DataTypeSignature; ///> NvData type in the specified NV range.
} NV_SYSTEM_DATA_GUID_TYPE;
extern EFI_GUID gEfiSystemNvDataHobGuid;

View File

@@ -16,30 +16,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
#ifndef _PLAT_DRI_OVER_LIB_H_
#define _PLAT_DRI_OVER_LIB_H_
#include <Protocol/PlatformDriverOverride.h>
#include <Protocol/DevicePath.h>
#include <Protocol/DriverBinding.h>
#include <Library/BaseLib.h>
#include <VariableFormat.h>
/**
Install the Platform Driver Override Protocol, and ensure there is only one Platform Driver Override Protocol
in the system.
@param gPlatformDriverOverride PlatformDriverOverride protocol interface which
needs to be installed
@retval EFI_ALREADY_STARTED There has been a Platform Driver Override
Protocol in the system, cannot install it again.
@retval EFI_SUCCESS The protocol is installed successfully.
**/
EFI_STATUS
EFIAPI
InstallPlatformDriverOverrideProtocol (
EFI_PLATFORM_DRIVER_OVERRIDE_PROTOCOL *gPlatformDriverOverride
);
/**
Free all the mapping database memory resource and initialize the mapping list entry.
@@ -57,8 +34,8 @@ FreeMappingDatabase (
);
/**
Read the environment variable(s) that contain the override mappings from Controller Device Path to
a set of Driver Device Paths, and create the mapping database in memory with those variable info.
Read the NV environment variable(s) that contain the override mappings from Controller Device Path to
a set of Driver Device Paths, and create the mapping database in memory to contain these variable info.
@param MappingDataBase Mapping database list entry pointer
@@ -76,6 +53,7 @@ InitOverridesMapping (
/**
Save the memory mapping database into NV environment variable(s).
If MappingDataBase list is empty, then delete all platform override NV variables.
@param MappingDataBase Mapping database list entry pointer
@@ -92,7 +70,6 @@ SaveOverridesMapping (
/**
Retrieves the image handle of the platform override driver for a controller in the system from the memory mapping database.
@param This A pointer to the EFI_PLATFORM_DRIVER_OVERRIDE_PROTOCOL instance.
@param ControllerHandle The device handle of the controller to check if
a driver override exists.
@param DriverImageHandle On output, a pointer to the next driver handle.
@@ -117,27 +94,14 @@ SaveOverridesMapping (
EFI_STATUS
EFIAPI
GetDriverFromMapping (
IN EFI_PLATFORM_DRIVER_OVERRIDE_PROTOCOL * This,
IN EFI_HANDLE ControllerHandle,
IN OUT EFI_HANDLE * DriverImageHandle,
IN LIST_ENTRY * MappingDataBase,
IN OUT EFI_HANDLE *DriverImageHandle,
IN LIST_ENTRY *MappingDataBase,
IN EFI_HANDLE CallerImageHandle
);
/**
Deletes all environment variable(s) that contain the override mappings from Controller Device Path to
a set of Driver Device Paths.
@retval EFI_SUCCESS Delete all variable(s) successfully.
**/
EFI_STATUS
EFIAPI
DeleteOverridesVariables (
VOID
);
/**
Check mapping database whether already has the mapping info which
Check mapping database whether already has the mapping info which
records the input Controller to input DriverImage.
@param ControllerDevicePath The controller device path is to be check.
@@ -214,22 +178,4 @@ DeleteDriverImage (
IN LIST_ENTRY *MappingDataBase
);
/**
Get the first Binding protocol which has the specific image handle
@param ImageHandle The Image handle
@param BindingHandle The BindingHandle of the found Driver Binding protocol.
If Binding protocol is not found, it is set to NULL.
@return Pointer into the Binding Protocol interface
@retval NULL The parameter is not valid or the binding protocol is not found.
**/
EFI_DRIVER_BINDING_PROTOCOL *
EFIAPI
GetBindingProtocolFromImageHandle (
IN EFI_HANDLE ImageHandle,
OUT EFI_HANDLE *BindingHandle
);
#endif

View File

@@ -43,7 +43,8 @@ typedef struct _EFI_FTW_LITE_PROTOCOL EFI_FTW_LITE_PROTOCOL;
@retval EFI_SUCCESS The function completed successfully
@retval EFI_ABORTED The function could not complete successfully.
@retval EFI_BAD_BUFFER_SIZE The input data can't fit within the target block.
@retval EFI_BAD_BUFFER_SIZE The input data can't fit within the FTW range.
The write buffer is too large to be supported.
@retval EFI_ACCESS_DENIED No writes have been allocated.
@retval EFI_OUT_OF_RESOURCES Cannot allocate enough memory resource.
@retval EFI_NOT_FOUND Cannot find FVB protocol by handle.

View File

@@ -94,10 +94,10 @@ typedef struct {
///
/// Variable State flags
///
#define VAR_IN_DELETED_TRANSITION 0xfe /// Variable is in obsolete transistion
#define VAR_DELETED 0xfd /// Variable is obsolete
#define VAR_HEADER_VALID_ONLY 0x7f /// Variable header has been valid
#define VAR_ADDED 0x3f /// Variable has been completely added
#define VAR_IN_DELETED_TRANSITION 0xfe ///< Variable is in obsolete transistion
#define VAR_DELETED 0xfd ///< Variable is obsolete
#define VAR_HEADER_VALID_ONLY 0x7f ///< Variable header has been valid
#define VAR_ADDED 0x3f ///< Variable has been completely added
///
/// Removed