Subrata Banik | 20fe24b | 2021-12-09 02:46:38 +0530 | [diff] [blame] | 1 | /** @file |
| 2 | UEFI Driver Family Protocol |
| 3 | |
| 4 | Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR> |
| 5 | SPDX-License-Identifier: BSD-2-Clause-Patent |
| 6 | |
| 7 | **/ |
| 8 | |
| 9 | #ifndef __EFI_DRIVER_FAMILY_OVERRIDE_H__ |
| 10 | #define __EFI_DRIVER_FAMILY_OVERRIDE_H__ |
| 11 | |
| 12 | #define EFI_DRIVER_FAMILY_OVERRIDE_PROTOCOL_GUID \ |
| 13 | { \ |
| 14 | 0xb1ee129e, 0xda36, 0x4181, { 0x91, 0xf8, 0x4, 0xa4, 0x92, 0x37, 0x66, 0xa7 } \ |
| 15 | } |
| 16 | |
| 17 | typedef struct _EFI_DRIVER_FAMILY_OVERRIDE_PROTOCOL EFI_DRIVER_FAMILY_OVERRIDE_PROTOCOL; |
| 18 | |
| 19 | // |
| 20 | // Prototypes for the Driver Family Override Protocol |
| 21 | // |
| 22 | // |
| 23 | /** |
| 24 | This function returns the version value associated with the driver specified by This. |
| 25 | |
| 26 | Retrieves the version of the driver that is used by the EFI Boot Service ConnectController() |
| 27 | to sort the set of Driver Binding Protocols in order from highest priority to lowest priority. |
| 28 | For drivers that support the Driver Family Override Protocol, those drivers are sorted so that |
| 29 | the drivers with higher values returned by GetVersion() are higher priority than drivers that |
| 30 | return lower values from GetVersion(). |
| 31 | |
| 32 | @param This A pointer to the EFI_DRIVER_FAMILY_OVERRIDE_PROTOCOL instance. |
| 33 | |
| 34 | @return The version value associated with the driver specified by This. |
| 35 | |
| 36 | **/ |
| 37 | typedef |
| 38 | UINT32 |
| 39 | (EFIAPI *EFI_DRIVER_FAMILY_OVERRIDE_GET_VERSION)( |
| 40 | IN EFI_DRIVER_FAMILY_OVERRIDE_PROTOCOL *This |
| 41 | ); |
| 42 | |
| 43 | /// |
| 44 | /// When installed, the Driver Family Override Protocol produces a GUID that represents |
| 45 | /// a family of drivers. Drivers with the same GUID are members of the same family |
| 46 | /// When drivers are connected to controllers, drivers with a higher revision value |
| 47 | /// in the same driver family are connected with a higher priority than drivers |
| 48 | /// with a lower revision value in the same driver family. The EFI Boot Service |
| 49 | /// Connect Controller uses five rules to build a prioritized list of drivers when |
| 50 | /// a request is made to connect a driver to a controller. The Driver Family Protocol |
| 51 | /// rule is between the Platform Specific Driver Override Protocol and above the |
| 52 | /// Bus Specific Driver Override Protocol. |
| 53 | /// |
| 54 | struct _EFI_DRIVER_FAMILY_OVERRIDE_PROTOCOL { |
| 55 | EFI_DRIVER_FAMILY_OVERRIDE_GET_VERSION GetVersion; |
| 56 | }; |
| 57 | |
| 58 | extern EFI_GUID gEfiDriverFamilyOverrideProtocolGuid; |
| 59 | |
| 60 | #endif |