diff options
author | lgao4 <lgao4@6f19259b-4bc3-4df7-8a09-765794883524> | 2008-12-11 09:30:13 +0000 |
---|---|---|
committer | lgao4 <lgao4@6f19259b-4bc3-4df7-8a09-765794883524> | 2008-12-11 09:30:13 +0000 |
commit | cebc8d486e39ffbbf37f67914db0a49455181e0f (patch) | |
tree | 2de34649e6ed690d939491037483a86364c2852b /MdeModulePkg | |
parent | c84507ab5229c462806187b090ba6249540c9070 (diff) | |
download | edk2-platforms-cebc8d486e39ffbbf37f67914db0a49455181e0f.tar.xz |
Code Scrub for Pcd, PlatformDriOverride and PlatOverMngr driver.
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@6998 6f19259b-4bc3-4df7-8a09-765794883524
Diffstat (limited to 'MdeModulePkg')
13 files changed, 214 insertions, 63 deletions
diff --git a/MdeModulePkg/Include/Library/IfrSupportLib.h b/MdeModulePkg/Include/Library/IfrSupportLib.h index 2caa6f0dca..1608d14ab1 100644 --- a/MdeModulePkg/Include/Library/IfrSupportLib.h +++ b/MdeModulePkg/Include/Library/IfrSupportLib.h @@ -439,8 +439,8 @@ CreateStringOpCode ( @param ConfigRequest The Config request string. If set to NULL, all the
configurable elements will be extracted from BlockNameArray.
- @param ConfigAltResp The returned <ConfigAltResp>.
@param Progress On return, points to a character in the Request.
+ @param ConfigAltResp The returned <ConfigAltResp>.
@param Guid GUID of the buffer storage.
@param Name Name of the buffer storage.
@param DriverHandle The DriverHandle which is used to invoke HiiDatabase
@@ -452,7 +452,8 @@ CreateStringOpCode ( The sequential input parameters will be number of
AltCfgId and DefaultValueArray pairs. When set to 0,
there will be no <AltResp>.
-
+ @param ... Variable argument list.
+
retval EFI_OUT_OF_RESOURCES Run out of memory resource.
retval EFI_INVALID_PARAMETER ConfigAltResp is NULL.
retval EFI_SUCCESS Operation successful.
diff --git a/MdeModulePkg/Include/Library/NetLib.h b/MdeModulePkg/Include/Library/NetLib.h index aa0b74e21a..6198e7e83a 100644 --- a/MdeModulePkg/Include/Library/NetLib.h +++ b/MdeModulePkg/Include/Library/NetLib.h @@ -660,7 +660,6 @@ NetLibGetMacString ( @param Protocol The protocol type in the IP header.
@param UseDefaultAddress Whether this instance is using default address or not.
- @retval None
**/
VOID
EFIAPI
diff --git a/MdeModulePkg/Library/DxeCrc32GuidedSectionExtractLib/DxeCrc32GuidedSectionExtractLib.c b/MdeModulePkg/Library/DxeCrc32GuidedSectionExtractLib/DxeCrc32GuidedSectionExtractLib.c index afc0ef32f7..e664428d0e 100644 --- a/MdeModulePkg/Library/DxeCrc32GuidedSectionExtractLib/DxeCrc32GuidedSectionExtractLib.c +++ b/MdeModulePkg/Library/DxeCrc32GuidedSectionExtractLib/DxeCrc32GuidedSectionExtractLib.c @@ -163,6 +163,9 @@ Crc32GuidedSectionHandler ( /**
Register Crc32 section handler.
+ @param ImageHandle ImageHandle of the loaded driver.
+ @param SystemTable Pointer to the EFI System Table.
+
@retval RETURN_SUCCESS Register successfully.
@retval RETURN_OUT_OF_RESOURCES No enough memory to register this handler.
**/
diff --git a/MdeModulePkg/Library/DxePlatDriOverLib/PlatDriOver.h b/MdeModulePkg/Library/DxePlatDriOverLib/PlatDriOver.h index db2d6e5dab..50622b8bd3 100644 --- a/MdeModulePkg/Library/DxePlatDriOverLib/PlatDriOver.h +++ b/MdeModulePkg/Library/DxePlatDriOverLib/PlatDriOver.h @@ -70,7 +70,7 @@ typedef struct _DEVICE_PATH_STACK_ITEM{ } DEVICE_PATH_STACK_ITEM;
/**
- Push a controller device path into a globle device path list
+ Push a controller device path into a globle device path list.
@param DevicePath The controller device path to push into stack
@@ -114,6 +114,8 @@ CheckExistInStack ( );
/**
+ Update the FV file device path if it is not valid.
+
According to a file GUID, check a Fv file device path is valid. If it is invalid,
try to return the valid device path.
FV address maybe changes for memory layout adjust from time to time, use this funciton
@@ -143,6 +145,8 @@ UpdateFvFileDevicePath ( );
/**
+ Gets the data and size of a variable.
+
Read the EFI variable (VendorGuid/Name) and return a dynamically allocated
buffer, and the size of the buffer. If failure return NULL.
@@ -165,6 +169,8 @@ GetVariableAndSize ( );
/**
+ Connect to the handle to a device on the device path.
+
This function will create all handles associate with every device
path node. If the handle associate with one device path node can not
be created success, then still give one chance to do the dispatch,
diff --git a/MdeModulePkg/Universal/PCD/Pei/Pcd.c b/MdeModulePkg/Universal/PCD/Pei/Pcd.c index b6fff5409b..ddf3a64195 100644 --- a/MdeModulePkg/Universal/PCD/Pei/Pcd.c +++ b/MdeModulePkg/Universal/PCD/Pei/Pcd.c @@ -1,8 +1,7 @@ /** @file
- PCD PEIM manage PCD database to manage all dynamic PCD in PEI phase. PCD PEIM
- also produce PCD_PPI.
+PCD PEIM produces PCD database to manage all dynamic PCD in PEI phase and install Pcd Ppi.
-Copyright (c) 2006, Intel Corporation
+Copyright (c) 2006 - 2008, Intel Corporation
All rights reserved. This program and the accompanying materials
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
diff --git a/MdeModulePkg/Universal/PCD/Pei/Pcd.inf b/MdeModulePkg/Universal/PCD/Pei/Pcd.inf index 8f43b11f82..bb85ab9bdb 100644 --- a/MdeModulePkg/Universal/PCD/Pei/Pcd.inf +++ b/MdeModulePkg/Universal/PCD/Pei/Pcd.inf @@ -1,8 +1,7 @@ #/** @file
-# Component description file for Pcd Database PEIM module
+# PCD PEIM produces PCD database to manage all dynamic PCD in PEI phase and install Pcd Ppi.
#
-# This PEIM driver implement and produce PCD PPI.
-# Copyright (c) 2006 - 2007, Intel Corporation
+# Copyright (c) 2006 - 2008, Intel Corporation
#
# All rights reserved. This program and the accompanying materials
# are licensed and made available under the terms and conditions of the BSD License
diff --git a/MdeModulePkg/Universal/PCD/Pei/Service.c b/MdeModulePkg/Universal/PCD/Pei/Service.c index fddab6be58..65e7e92cfc 100644 --- a/MdeModulePkg/Universal/PCD/Pei/Service.c +++ b/MdeModulePkg/Universal/PCD/Pei/Service.c @@ -1,7 +1,7 @@ /** @file
Private functions used by PCD PEIM.
-Copyright (c) 2006, Intel Corporation
+Copyright (c) 2006 - 2008, Intel Corporation
All rights reserved. This program and the accompanying materials
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
@@ -10,9 +10,6 @@ http://opensource.org/licenses/bsd-license.php THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-
-Module Name: Service.c
-
**/
#include "Service.h"
diff --git a/MdeModulePkg/Universal/PCD/Pei/Service.h b/MdeModulePkg/Universal/PCD/Pei/Service.h index e163a9a1a2..06cb24721f 100644 --- a/MdeModulePkg/Universal/PCD/Pei/Service.h +++ b/MdeModulePkg/Universal/PCD/Pei/Service.h @@ -1,7 +1,7 @@ /** @file
Private functions used by PCD PEIM.
-Copyright (c) 2006, Intel Corporation
+Copyright (c) 2006 - 2008, Intel Corporation
All rights reserved. This program and the accompanying materials
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
@@ -10,9 +10,6 @@ http://opensource.org/licenses/bsd-license.php THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-
-Module Name: Service.h
-
**/
#ifndef _PEI_PCD_SERVICE_H_
@@ -1007,11 +1004,13 @@ SetPtrTypeSize ( IN PEI_PCD_DATABASE *Database
);
-
extern EFI_GUID gPcdDataBaseHobGuid;
extern EFI_GUID gPcdPeiCallbackFnTableHobGuid;
+//
+// The init Database created by PCD Database generation tool
+//
extern PEI_PCD_DATABASE_INIT gPEIPcdDbInit;
#endif
diff --git a/MdeModulePkg/Universal/PcatSingleSegmentPciCfg2Pei/PciCfg2.c b/MdeModulePkg/Universal/PcatSingleSegmentPciCfg2Pei/PciCfg2.c index 0d899c9260..6ea2cfb8e8 100644 --- a/MdeModulePkg/Universal/PcatSingleSegmentPciCfg2Pei/PciCfg2.c +++ b/MdeModulePkg/Universal/PcatSingleSegmentPciCfg2Pei/PciCfg2.c @@ -55,7 +55,7 @@ PciCfg2Read ( IN EFI_PEI_PCI_CFG_PPI_WIDTH Width,
IN UINT64 Address,
IN OUT VOID *Buffer
-);
+ );
/**
Write to a given location in the PCI configuration space.
@@ -89,7 +89,7 @@ PciCfg2Write ( IN EFI_PEI_PCI_CFG_PPI_WIDTH Width,
IN UINT64 Address,
IN OUT VOID *Buffer
-);
+ );
/**
@@ -130,7 +130,7 @@ PciCfg2Modify ( IN UINT64 Address,
IN VOID *SetBits,
IN VOID *ClearBits
-);
+ );
@@ -218,7 +218,7 @@ PciCfg2Read ( IN EFI_PEI_PCI_CFG_PPI_WIDTH Width,
IN UINT64 Address,
IN OUT VOID *Buffer
-)
+ )
{
UINTN PciLibAddress;
@@ -269,7 +269,7 @@ PciCfg2Write ( IN EFI_PEI_PCI_CFG_PPI_WIDTH Width,
IN UINT64 Address,
IN OUT VOID *Buffer
-)
+ )
{
UINTN PciLibAddress;
@@ -327,7 +327,7 @@ PciCfg2Modify ( IN UINT64 Address,
IN VOID *SetBits,
IN VOID *ClearBits
-)
+ )
{
UINTN PciLibAddress;
UINT16 ClearValue16;
@@ -353,7 +353,15 @@ PciCfg2Modify ( return EFI_SUCCESS;
}
+/**
+ Module's entry function.
+ This routine will install EFI_PEI_PCI_CFG2_PPI.
+
+ @param FileHandle Handle of the file being invoked.
+ @param PeiServices Describes the list of possible PEI Services.
+ @return Whether success to install service.
+**/
EFI_STATUS
EFIAPI
PeimInitializePciCfg (
diff --git a/MdeModulePkg/Universal/PlatformDriverOverride/PlatOverMngr/PlatOverMngr.c b/MdeModulePkg/Universal/PlatformDriverOverride/PlatOverMngr/PlatOverMngr.c index 5d9bfe127a..5f49a5b926 100644 --- a/MdeModulePkg/Universal/PlatformDriverOverride/PlatOverMngr/PlatOverMngr.c +++ b/MdeModulePkg/Universal/PlatformDriverOverride/PlatOverMngr/PlatOverMngr.c @@ -336,7 +336,7 @@ GetComponentName ( **/
CHAR16 *
GetImageName (
- EFI_LOADED_IMAGE_PROTOCOL *Image
+ IN EFI_LOADED_IMAGE_PROTOCOL *Image
)
{
EFI_STATUS Status;
@@ -347,9 +347,9 @@ GetImageName ( UINTN BufferSize;
UINT32 AuthenticationStatus;
EFI_GUID *NameGuid;
- EFI_FIRMWARE_VOLUME2_PROTOCOL *FV2;
+ EFI_FIRMWARE_VOLUME2_PROTOCOL *Fv2;
- FV2 = NULL;
+ Fv2 = NULL;
Buffer = NULL;
BufferSize = 0;
@@ -378,11 +378,11 @@ GetImageName ( Status = gBS->HandleProtocol (
Image->DeviceHandle,
&gEfiFirmwareVolume2ProtocolGuid,
- (VOID **) &FV2
+ (VOID **) &Fv2
);
if (!EFI_ERROR (Status)) {
- Status = FV2->ReadSection (
- FV2,
+ Status = Fv2->ReadSection (
+ Fv2,
&FvFilePath->FvFileName,
EFI_SECTION_USER_INTERFACE,
0,
@@ -1158,12 +1158,12 @@ PlatOverMngrExtractConfig ( /**
This function processes the results of changes in configuration.
- @param This Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.
- @param Request A null-terminated Unicode string in <ConfigRequest> format.
- @param Progress A pointer to a string filled in with the offset of the most
- recent '&' before the first failing name/value pair (or the
- beginning of the string if the failure is in the first
- name/value pair) or the terminating NULL if all was successful.
+ @param This Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.
+ @param Configuration A null-terminated Unicode string in <ConfigRequest> format.
+ @param Progress A pointer to a string filled in with the offset of the most
+ recent '&' before the first failing name/value pair (or the
+ beginning of the string if the failure is in the first
+ name/value pair) or the terminating NULL if all was successful.
@retval EFI_SUCCESS The Results is processed successfully.
@retval EFI_INVALID_PARAMETER Configuration is NULL.
diff --git a/MdeModulePkg/Universal/PlatformDriverOverride/PlatOverMngr/PlatOverMngr.h b/MdeModulePkg/Universal/PlatformDriverOverride/PlatOverMngr/PlatOverMngr.h index f1f4e1c801..a7ce6dbbdb 100644 --- a/MdeModulePkg/Universal/PlatformDriverOverride/PlatOverMngr/PlatOverMngr.h +++ b/MdeModulePkg/Universal/PlatformDriverOverride/PlatOverMngr/PlatOverMngr.h @@ -134,15 +134,51 @@ typedef struct { EFI_STRING_ID DescriptionToken;
} CFG_PROTOCOL_INVOKER_CHOICE;
+/**
+ This function allows a caller to extract the current configuration for one
+ or more named elements from the target driver.
+
+ @param This Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.
+ @param Request A null-terminated Unicode string in <ConfigRequest> format.
+ @param Progress On return, points to a character in the Request string.
+ Points to the string's null terminator if request was successful.
+ Points to the most recent '&' before the first failing name/value
+ pair (or the beginning of the string if the failure is in the
+ first name/value pair) if the request was not successful.
+ @param Results A null-terminated Unicode string in <ConfigAltResp> format which
+ has all values filled in for the names in the Request string.
+ String to be allocated by the called function.
+
+ @retval EFI_SUCCESS The Results is filled with the requested values.
+ @retval EFI_OUT_OF_RESOURCES Not enough memory to store the results.
+ @retval EFI_INVALID_PARAMETER Request is NULL, illegal syntax, or unknown name.
+ @retval EFI_NOT_FOUND Routing data doesn't match any storage in this driver.
+
+**/
EFI_STATUS
EFIAPI
PlatOverMngrExtractConfig (
- IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL *This,
+ IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL *This,
IN CONST EFI_STRING Request,
OUT EFI_STRING *Progress,
OUT EFI_STRING *Results
);
+/**
+ This function processes the results of changes in configuration.
+
+ @param This Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.
+ @param Configuration A null-terminated Unicode string in <ConfigRequest> format.
+ @param Progress A pointer to a string filled in with the offset of the most
+ recent '&' before the first failing name/value pair (or the
+ beginning of the string if the failure is in the first
+ name/value pair) or the terminating NULL if all was successful.
+
+ @retval EFI_SUCCESS The Results is processed successfully.
+ @retval EFI_INVALID_PARAMETER Configuration is NULL.
+ @retval EFI_NOT_FOUND Routing data doesn't match any storage in this driver.
+
+**/
EFI_STATUS
EFIAPI
PlatOverMngrRouteConfig (
@@ -151,6 +187,27 @@ PlatOverMngrRouteConfig ( OUT EFI_STRING *Progress
);
+/**
+ This is the function that is called to provide results data to the driver. This data
+ consists of a unique key which is used to identify what data is either being passed back
+ or being asked for.
+
+ @param This Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.
+ @param Action A null-terminated Unicode string in <ConfigRequest> format.
+ @param KeyValue A unique Goto OpCode callback value which record user's selection.
+ 0x100 <= KeyValue <0x500 : user select a controller item in the first page;
+ KeyValue == 0x1234 : user select 'Refresh' in first page, or user select 'Go to Previous Menu' in second page
+ KeyValue == 0x1235 : user select 'Pci device filter' in first page
+ KeyValue == 0x1500 : user select 'order ... priority' item in second page
+ KeyValue == 0x1800 : user select 'commint changes' in third page
+ KeyValue == 0x2000 : user select 'Go to Previous Menu' in third page
+ @param Type The type of value for the question.
+ @param Value A pointer to the data being sent to the original exporting driver.
+ @param ActionRequest On return, points to the action requested by the callback function.
+
+ @retval EFI_SUCCESS Always returned.
+
+**/
EFI_STATUS
EFIAPI
PlatOverMngrCallback (
@@ -162,14 +219,32 @@ PlatOverMngrCallback ( OUT EFI_BROWSER_ACTION_REQUEST *ActionRequest
);
+/**
+ Get the image name
+
+ @param Image Image to search.
+
+ @retval !NULL Pointer into the image name if the image name is found,
+ @retval NULL Pointer to NULL if the image name is not found.
+
+**/
CHAR16 *
GetImageName (
- IN EFI_LOADED_IMAGE_PROTOCOL *Image
+ IN EFI_LOADED_IMAGE_PROTOCOL *Image
);
-CHAR16 *
+/**
+ Get the description string by device path.
+
+ @param DevPath The input device path.
+
+ @retval !NULL The description string retured.
+ @retval NULL The description string cannot be found.
+
+**/
+CHAR16 *
DevicePathToStr (
- EFI_DEVICE_PATH_PROTOCOL *DevPath
+ IN EFI_DEVICE_PATH_PROTOCOL *DevPath
);
#endif
diff --git a/MdeModulePkg/Universal/PlatformDriverOverride/PlatformDriOverrideDxe/PlatformDriOverride.c b/MdeModulePkg/Universal/PlatformDriverOverride/PlatformDriOverrideDxe/PlatformDriOverride.c index 75032720fd..fd3aee9ad0 100644 --- a/MdeModulePkg/Universal/PlatformDriverOverride/PlatformDriOverrideDxe/PlatformDriOverride.c +++ b/MdeModulePkg/Universal/PlatformDriverOverride/PlatformDriOverrideDxe/PlatformDriOverride.c @@ -31,25 +31,23 @@ LIST_ENTRY mMappingDataBase = INITIALIZE_LIST_HEAD_VARIABLE (mMappingDataBa BOOLEAN mEnvironmentVariableRead = FALSE;
EFI_HANDLE mCallerImageHandle;
+/**
+ Platform Driver Override driver entry point, install the Platform Driver Override Protocol
+
+ @param ImageHandle ImageHandle of the loaded driver.
+ @param SystemTable Pointer to the EFI System Table.
+ @retval EFI_SUCCESS The DXE Driver, DXE Runtime Driver, DXE SMM Driver,
+ or UEFI Driver exited normally.
+ @retval EFI_INCOMPATIBLE_VERSION _gUefiDriverRevision is greater than SystemTable->Hdr.Revision.
+ @retval Other Return value from ProcessModuleEntryPointList().
+**/
EFI_STATUS
EFIAPI
PlatformDriverOverrideEntry (
IN EFI_HANDLE ImageHandle,
IN EFI_SYSTEM_TABLE *SystemTable
)
-/*++
-
-Routine Description:
- Platform Driver Override driver entry point, install the Platform Driver Override Protocol
-
-Arguments:
- (Standard EFI Image entry - EFI_IMAGE_ENTRY_POINT)
-
-Returns:
- EFI_STATUS
-
---*/
{
mEnvironmentVariableRead = FALSE;
mCallerImageHandle = ImageHandle;
@@ -145,11 +143,16 @@ GetDriver ( /**
- For the use of the ControllerHandle parameter in the GetDriverPath() and DriverLoaded() APIs
- makes those APIs very difficult to use, so not support.
-
-
+ For the use of the ControllerHandle parameter in the GetDriverPath()
+ But this API is very difficult to use, so not support.
+ @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 DriverImagePath The device path for this Image.
+
+ @retval EFI_UNSUPPORTED
**/
EFI_STATUS
EFIAPI
@@ -164,11 +167,21 @@ GetDriverPath ( /**
- For the use of the ControllerHandle parameter in the GetDriverPath() and DriverLoaded() APIs
- makes those APIs very difficult to use, so not support.
-
-
+ For the use of the ControllerHandle parameter in the DriverLoaded()
+ But this API is very difficult to use, so not support.
+ @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 DriverImagePath The device path for this Image.
+ @param DriverImageHandle On input, a pointer to the previous driver image
+ handle returned by GetDriver(). On output, a
+ pointer to the next driver image handle. Passing
+ in a NULL, will return the first driver image
+ handle for ControllerHandle.
+
+ @retval EFI_UNSUPPORTED
**/
EFI_STATUS
EFIAPI
diff --git a/MdeModulePkg/Universal/PlatformDriverOverride/PlatformDriOverrideDxe/PlatformDriOverride.h b/MdeModulePkg/Universal/PlatformDriverOverride/PlatformDriOverrideDxe/PlatformDriOverride.h index 2fa2ae8929..31f2077be9 100644 --- a/MdeModulePkg/Universal/PlatformDriverOverride/PlatformDriOverrideDxe/PlatformDriOverride.h +++ b/MdeModulePkg/Universal/PlatformDriverOverride/PlatformDriOverrideDxe/PlatformDriOverride.h @@ -18,8 +18,8 @@ Abstract: **/
-#ifndef PLATFORM_DRI_OVERRIDE_H_
-#define PLATFORM_DRI_OVERRIDE_H_
+#ifndef _PLATFORM_DRI_OVERRIDE_H_
+#define _PLATFORM_DRI_OVERRIDE_H_
#include <Uefi.h>
@@ -28,6 +28,29 @@ Abstract: #include <Library/BaseLib.h>
#include <Library/PlatDriOverLib.h>
+/**
+ Retrieves the image handle of the platform override driver for a controller in the system.
+
+ @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 input, a pointer to the previous driver image
+ handle returned by GetDriver(). On output, a
+ pointer to the next driver image handle. Passing
+ in a NULL, will return the first driver image
+ handle for ControllerHandle.
+
+ @retval EFI_SUCCESS The driver override for ControllerHandle was
+ returned in DriverImageHandle.
+ @retval EFI_NOT_FOUND A driver override for ControllerHandle was not
+ found.
+ @retval EFI_INVALID_PARAMETER The handle specified by ControllerHandle is not a
+ valid handle. DriverImageHandle is not a handle
+ that was returned on a previous call to
+ GetDriver().
+
+**/
EFI_STATUS
EFIAPI
GetDriver (
@@ -36,6 +59,18 @@ GetDriver ( IN OUT EFI_HANDLE * DriverImageHandle
);
+/**
+ For the use of the ControllerHandle parameter in the GetDriverPath()
+ But this API is very difficult to use, so not support.
+
+ @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 DriverImagePath The device path for this Image.
+
+ @retval EFI_UNSUPPORTED
+**/
EFI_STATUS
EFIAPI
GetDriverPath (
@@ -44,6 +79,23 @@ GetDriverPath ( IN OUT EFI_DEVICE_PATH_PROTOCOL **DriverImagePath
);
+/**
+ For the use of the ControllerHandle parameter in the DriverLoaded()
+ But this API is very difficult to use, so not support.
+
+ @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 DriverImagePath The device path for this Image.
+ @param DriverImageHandle On input, a pointer to the previous driver image
+ handle returned by GetDriver(). On output, a
+ pointer to the next driver image handle. Passing
+ in a NULL, will return the first driver image
+ handle for ControllerHandle.
+
+ @retval EFI_UNSUPPORTED
+**/
EFI_STATUS
EFIAPI
DriverLoaded (
|