X-Git-Url: https://git.proxmox.com/?a=blobdiff_plain;f=MdePkg%2FInclude%2FProtocol%2FPlatformDriverOverride.h;h=0fe42fc0a6742ea9901fba2d658ee0ea3e0d9a05;hb=5d2e8ef0d3b13d5f73c9b4dc0bbbf59f758d5c06;hp=018f64d9d956095e50b7186c278a22f1b921cb33;hpb=cce6f7aa66125df1bddf24c122f02093d47ef204;p=mirror_edk2.git diff --git a/MdePkg/Include/Protocol/PlatformDriverOverride.h b/MdePkg/Include/Protocol/PlatformDriverOverride.h index 018f64d9d9..0fe42fc0a6 100644 --- a/MdePkg/Include/Protocol/PlatformDriverOverride.h +++ b/MdePkg/Include/Protocol/PlatformDriverOverride.h @@ -1,8 +1,8 @@ /** @file Platform Driver Override protocol as defined in the UEFI 2.1 specification. - Copyright (c) 2006 - 2008, Intel Corporation - All rights reserved. This program and the accompanying materials + Copyright (c) 2006 - 2011, 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 http://opensource.org/licenses/bsd-license.php @@ -43,7 +43,7 @@ typedef struct _EFI_PLATFORM_DRIVER_OVERRIDE_PROTOCOL EFI_PLATFORM_DRIVER_OVERR @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. + @retval EFI_INVALID_PARAMETER The handle specified by ControllerHandle is NULL. @retval EFI_INVALID_PARAMETER DriverImageHandle is not a handle that was returned on a previous call to GetDriver(). @@ -59,19 +59,19 @@ EFI_STATUS /** Retrieves the device path of the platform override driver for a controller in the system. - @param This A pointer to the EFI_PLATFORM_DRIVER_OVERRIDE_ - PROTOCOL instance. + @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 GetDriverPath(). On output, a pointer to the next driver - device path. + @param DriverImagePath On input, a pointer to the previous driver device path returned by + GetDriverPath(). On output, a pointer to the next driver + device path. Passing in a pointer to NULL will return the first + driver device path for ControllerHandle. @retval EFI_SUCCESS The driver override for ControllerHandle was returned in DriverImageHandle. @retval EFI_UNSUPPORTED The operation is not supported. @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. + @retval EFI_INVALID_PARAMETER The handle specified by ControllerHandle is NULL. @retval EFI_INVALID_PARAMETER DriverImagePath is not a device path that was returned on a previous call to GetDriverPath(). @@ -105,7 +105,7 @@ EFI_STATUS @retval EFI_NOT_FOUND DriverImagePath is not a device path that was returned on a prior call to GetDriverPath() for the controller specified by ControllerHandle. - @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid device handle. + @retval EFI_INVALID_PARAMETER ControllerHandle is NULL. @retval EFI_INVALID_PARAMETER DriverImagePath is not a valid device path. @retval EFI_INVALID_PARAMETER DriverImageHandle is not a valid image handle. @@ -119,20 +119,16 @@ EFI_STATUS IN EFI_HANDLE DriverImageHandle ); -// -// Interface structure for the Platform Driver Override Protocol -// -/** - @par Protocol Description: - This protocol matches one or more drivers to a controller. A platform driver - produces this protocol, and it is installed on a separate handle. This protocol - is used by the ConnectController() boot service to select the best driver - for a controller. All of the drivers returned by this protocol have a higher - precedence than drivers found from an EFI Bus Specific Driver Override Protocol - or drivers found from the general UEFI driver Binding search algorithm. If more - than one driver is returned by this protocol, then the drivers are returned in - order from highest precedence to lowest precedence. -**/ +/// +/// This protocol matches one or more drivers to a controller. A platform driver +/// produces this protocol, and it is installed on a separate handle. This protocol +/// is used by the ConnectController() boot service to select the best driver +/// for a controller. All of the drivers returned by this protocol have a higher +/// precedence than drivers found from an EFI Bus Specific Driver Override Protocol +/// or drivers found from the general UEFI driver Binding search algorithm. If more +/// than one driver is returned by this protocol, then the drivers are returned in +/// order from highest precedence to lowest precedence. +/// struct _EFI_PLATFORM_DRIVER_OVERRIDE_PROTOCOL { EFI_PLATFORM_DRIVER_OVERRIDE_GET_DRIVER GetDriver; EFI_PLATFORM_DRIVER_OVERRIDE_GET_DRIVER_PATH GetDriverPath;