sync comments, fix function header, rename variable name to follow coding style.

[mirror_edk2.git] / MdeModulePkg / Universal / PlatformDriverOverride / PlatOverMngr / PlatOverMngr.h

/** @file\r
\r
Copyright (c) 2007 - 2008, Intel Corporation\r
All rights reserved. This program and the accompanying materials\r
are licensed and made available under the terms and conditions of the BSD License\r
which accompanies this distribution.  The full text of the license may be found at\r
http://opensource.org/licenses/bsd-license.php\r
\r
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
Module Name:\r
\r
  PlatOverMngr.h\r
\r
Abstract:\r
\r
  Function prototype for platform driver override manager driver\r
\r
**/\r
\r
#ifndef _PLAT_OVER_MNGR_H_\r
#define _PLAT_OVER_MNGR_H_\r
\r
#include <PiDxe.h>\r
\r
#include <Protocol/HiiConfigAccess.h>\r
#include <Protocol/HiiConfigRouting.h>\r
#include <Protocol/HiiDatabase.h>\r
#include <Protocol/LoadedImage.h>\r
#include <Protocol/FirmwareVolumeBlock.h>\r
#include <Protocol/FirmwareVolume2.h>\r
#include <Protocol/PciIo.h>\r
#include <Protocol/BusSpecificDriverOverride.h>\r
#include <Protocol/ComponentName2.h>\r
#include <Protocol/ComponentName.h>\r
#include <Protocol/DevicePathToText.h>\r
\r
#include <Library/BaseLib.h>\r
#include <Library/DebugLib.h>\r
#include <Library/UefiLib.h>\r
#include <Library/UefiApplicationEntryPoint.h>\r
#include <Library/UefiBootServicesTableLib.h>\r
#include <Library/PlatDriOverLib.h>\r
#include <Library/IfrSupportLib.h>\r
#include <Library/ExtendedIfrSupportLib.h>\r
#include <Library/BaseMemoryLib.h>\r
#include <Library/MemoryAllocationLib.h>\r
#include <Library/HiiLib.h>\r
#include <Library/ExtendedHiiLib.h>\r
#include <Library/UefiRuntimeServicesTableLib.h>\r
#include <Library/DevicePathLib.h>\r
\r
#define MIN_ALIGNMENT_SIZE  4\r
#define ALIGN_SIZE(a)       ((a % MIN_ALIGNMENT_SIZE) ? MIN_ALIGNMENT_SIZE - (a % MIN_ALIGNMENT_SIZE) : 0)\r
\r
\r
#define EFI_CALLBACK_INFO_SIGNATURE EFI_SIGNATURE_32 ('C', 'l', 'b', 'k')\r
#define EFI_CALLBACK_INFO_FROM_THIS(a)  CR (a, EFI_CALLBACK_INFO, ConfigAccess, EFI_CALLBACK_INFO_SIGNATURE)\r
#define MAX_CHOICE_NUM    0x100\r
#define UPDATE_DATA_SIZE  0x1000\r
\r
\r
extern UINT8  VfrBin[];\r
\r
extern UINT8  PlatOverMngrStrings[];\r
\r
//\r
// Following definition is the same as in vfr file\r
//\r
#define PLAT_OVER_MNGR_GUID \\r
  { \\r
    0x8614567d, 0x35be, 0x4415, 0x8d, 0x88, 0xbd, 0x7d, 0xc, 0x9c, 0x70, 0xc0 \\r
  }\r
\r
typedef struct {\r
  UINT8   DriSelection[100];\r
  UINT8   DriOrder[100];\r
  UINT8   PciDeviceFilter;\r
} PLAT_OVER_MNGR_DATA;\r
\r
#define FORM_ID_DEVICE                 0x1234\r
#define FORM_ID_DRIVER                 0x1200\r
#define FORM_ID_ORDER                  0x1500\r
\r
#define KEY_VALUE_DEVICE_OFFSET        0x0100\r
#define KEY_VALUE_DEVICE_MAX           0x04ff\r
\r
#define QUESTION_ID_OFFSET             0x0500\r
\r
#define KEY_VALUE_DEVICE_REFRESH       0x1234\r
#define KEY_VALUE_DEVICE_FILTER        0x1235\r
#define KEY_VALUE_DEVICE_CLEAR         0x1236\r
\r
#define KEY_VALUE_DRIVER_GOTO_PREVIOUS 0x1300\r
#define KEY_VALUE_DRIVER_GOTO_ORDER    0x1301\r
\r
#define KEY_VALUE_ORDER_GOTO_PREVIOUS  0x2000\r
#define KEY_VALUE_ORDER_SAVE_AND_EXIT  0x1800\r
\r
#define VARSTORE_ID_PLAT_OVER_MNGR     0x1000\r
\r
//\r
// Question Id start from 1, so define an offset for it\r
//\r
#define VAR_OFFSET(Field)              ((UINTN) &(((PLAT_OVER_MNGR_DATA *) 0)->Field))\r
\r
#define DRIVER_SELECTION_VAR_OFFSET     (VAR_OFFSET (DriSelection))\r
#define DRIVER_ORDER_VAR_OFFSET         (VAR_OFFSET (DriOrder))\r
\r
#define DRIVER_SELECTION_QUESTION_ID    (VAR_OFFSET (DriSelection) + QUESTION_ID_OFFSET)\r
#define DRIVER_ORDER_QUESTION_ID        (VAR_OFFSET (DriOrder) + QUESTION_ID_OFFSET)\r
\r
typedef struct {\r
  UINTN                           Signature;\r
\r
  EFI_HANDLE                      DriverHandle;\r
  EFI_HII_HANDLE                  RegisteredHandle;\r
  PLAT_OVER_MNGR_DATA             FakeNvData;\r
\r
  EFI_HII_CONFIG_ROUTING_PROTOCOL *HiiConfigRouting;\r
\r
  EFI_HII_CONFIG_ACCESS_PROTOCOL  ConfigAccess;\r
} EFI_CALLBACK_INFO;\r
\r
typedef struct {\r
  EFI_DRIVER_CONFIGURATION_PROTOCOL         *DriverConfiguration;\r
  EFI_HANDLE                                DriverImageHandle;\r
  EFI_HANDLE                                ControllerHandle;\r
  EFI_HANDLE                                ChildControllerHandle;\r
  //\r
  // To avoid created string leak in Hii database, use this token to reuse every token created by the driver\r
  //\r
  EFI_STRING_ID                             DescriptionToken;\r
} CFG_PROTOCOL_INVOKER_CHOICE;\r
\r
EFI_STATUS\r
EFIAPI\r
PlatOverMngrExtractConfig (\r
  IN  CONST EFI_HII_CONFIG_ACCESS_PROTOCOL   *This,\r
  IN  CONST EFI_STRING                       Request,\r
  OUT EFI_STRING                             *Progress,\r
  OUT EFI_STRING                             *Results\r
  );\r
\r
EFI_STATUS\r
EFIAPI\r
PlatOverMngrRouteConfig (\r
  IN  CONST EFI_HII_CONFIG_ACCESS_PROTOCOL   *This,\r
  IN  CONST EFI_STRING                       Configuration,\r
  OUT EFI_STRING                             *Progress\r
  );\r
\r
EFI_STATUS\r
EFIAPI\r
PlatOverMngrCallback (\r
  IN  CONST EFI_HII_CONFIG_ACCESS_PROTOCOL   *This,\r
  IN  EFI_BROWSER_ACTION                     Action,\r
  IN  EFI_QUESTION_ID                        KeyValue,\r
  IN  UINT8                                  Type,\r
  IN  EFI_IFR_TYPE_VALUE                     *Value,\r
  OUT EFI_BROWSER_ACTION_REQUEST             *ActionRequest\r
  );\r
\r
CHAR16 *\r
GetImageName (\r
  IN  EFI_LOADED_IMAGE_PROTOCOL *Image\r
  );\r
\r
CHAR16  *\r
DevicePathToStr (\r
  EFI_DEVICE_PATH_PROTOCOL     *DevPath\r
  );\r
\r
#endif\r