SecurityPkg: Replace UnicodeStrToAsciiStr/AsciiStrToUnicodeStr

[mirror_edk2.git] / SecurityPkg / Tcg / Opal / OpalPasswordDxe / OpalHiiPrivate.h

/** @file\r
  Private functions and sturctures used by the Opal UEFI Driver.\r
\r
Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>\r
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
**/\r
\r
#ifndef _OPAL_HII_PRIVATE_H_\r
#define _OPAL_HII_PRIVATE_H_\r
\r
\r
\r
#include <Library/OpalPasswordSupportLib.h>\r
#include <Protocol/HiiConfigAccess.h>\r
\r
#include "OpalHii.h"\r
#include "OpalHiiFormValues.h"\r
\r
\r
#define  OPAL_PASSWORD_CONFIG_GUID \\r
  { \\r
    0x0d510a4f, 0xa81b, 0x473f, { 0x87, 0x07, 0xb7, 0xfd, 0xfb, 0xc0, 0x45, 0xba } \\r
  }\r
\r
#pragma pack(1)\r
\r
typedef struct {\r
  UINT16 Id: HII_KEY_ID_BITS;\r
  UINT16 Index: HII_KEY_INDEX_BITS;\r
  UINT16 Flag: HII_KEY_FLAG_BITS;\r
} KEY_BITS;\r
\r
typedef union {\r
    UINT16    Raw;\r
    KEY_BITS  KeyBits;\r
} HII_KEY;\r
\r
typedef struct {\r
    VENDOR_DEVICE_PATH             VendorDevicePath;\r
    EFI_DEVICE_PATH_PROTOCOL       End;\r
} HII_VENDOR_DEVICE_PATH;\r
\r
/**\r
* Opal PSID Authority utilized for PSID revert\r
*\r
* The type indicates the structure of the PSID authority\r
*/\r
typedef struct {\r
    UINT8 Psid[PSID_CHARACTER_LENGTH];\r
} TCG_PSID;\r
\r
/**\r
  This function processes the results of changes in configuration.\r
\r
  @param  This                   Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.\r
  @param  Configuration          A null-terminated Unicode string in <ConfigResp>\r
                                 format.\r
  @param  Progress               A pointer to a string filled in with the offset of\r
                                 the most recent '&' before the first failing\r
                                 name/value pair (or the beginning of the string if\r
                                 the failure is in the first name/value pair) or\r
                                 the terminating NULL if all was successful.\r
\r
  @retval EFI_SUCCESS            The Results is processed successfully.\r
  @retval EFI_INVALID_PARAMETER  Configuration is NULL.\r
  @retval EFI_NOT_FOUND          Routing data doesn't match any storage in this\r
                                 driver.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
RouteConfig(\r
  CONST EFI_HII_CONFIG_ACCESS_PROTOCOL    *This,\r
  CONST EFI_STRING                        Configuration,\r
  EFI_STRING                              *Progress\r
  );\r
\r
/**\r
  This function allows a caller to extract the current configuration for one\r
  or more named elements from the target driver.\r
\r
  @param  This                   Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.\r
  @param  Request                A null-terminated Unicode string in\r
                                 <ConfigRequest> format.\r
  @param  Progress               On return, points to a character in the Request\r
                                 string. Points to the string's null terminator if\r
                                 request was successful. Points to the most recent\r
                                 '&' before the first failing name/value pair (or\r
                                 the beginning of the string if the failure is in\r
                                 the first name/value pair) if the request was not\r
                                 successful.\r
  @param  Results                A null-terminated Unicode string in\r
                                 <ConfigAltResp> format which has all values filled\r
                                 in for the names in the Request string. String to\r
                                 be allocated by the called function.\r
\r
  @retval EFI_SUCCESS            The Results is filled with the requested values.\r
  @retval EFI_OUT_OF_RESOURCES   Not enough memory to store the results.\r
  @retval EFI_INVALID_PARAMETER  Request is illegal syntax, or unknown name.\r
  @retval EFI_NOT_FOUND          Routing data doesn't match any storage in this\r
                                 driver.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
ExtractConfig(\r
  CONST EFI_HII_CONFIG_ACCESS_PROTOCOL    *This,\r
  CONST EFI_STRING                        Request,\r
  EFI_STRING                              *Progress,\r
  EFI_STRING                              *Results\r
  );\r
\r
/**\r
  This function processes the results of changes in configuration.\r
\r
  @param  This                   Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.\r
  @param  Action                 Specifies the type of action taken by the browser.\r
  @param  QuestionId             A unique value which is sent to the original\r
                                 exporting driver so that it can identify the type\r
                                 of data to expect.\r
  @param  Type                   The type of value for the question.\r
  @param  Value                  A pointer to the data being sent to the original\r
                                 exporting driver.\r
  @param  ActionRequest          On return, points to the action requested by the\r
                                 callback function.\r
\r
  @retval EFI_SUCCESS            The callback successfully handled the action.\r
  @retval EFI_OUT_OF_RESOURCES   Not enough storage is available to hold the\r
                                 variable and its data.\r
  @retval EFI_DEVICE_ERROR       The variable could not be saved.\r
  @retval EFI_UNSUPPORTED        The specified Action is not supported by the\r
                                 callback.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
DriverCallback(\r
  CONST EFI_HII_CONFIG_ACCESS_PROTOCOL*   This,\r
  EFI_BROWSER_ACTION                      Action,\r
  EFI_QUESTION_ID                         QuestionId,\r
  UINT8                                   Type,\r
  EFI_IFR_TYPE_VALUE*                     Value,\r
  EFI_BROWSER_ACTION_REQUEST*             ActionRequest\r
  );\r
\r
/**\r
\r
  Pass the current system state to the bios via the hii_G_Configuration.\r
\r
**/\r
VOID\r
OpalHiiSetBrowserData (\r
  VOID\r
  );\r
\r
/**\r
\r
  Populate the hii_g_Configuraton with the browser Data.\r
\r
**/\r
VOID\r
OpalHiiGetBrowserData (\r
  VOID\r
  );\r
\r
/**\r
  Draws the disk info form.\r
\r
  @retval  EFI_SUCCESS       Draw the disk info success.\r
\r
**/\r
EFI_STATUS\r
HiiPopulateDiskInfoForm(\r
  VOID\r
  );\r
\r
/**\r
  Update the global Disk index info.\r
\r
  @param   Index             The input disk index info.\r
\r
  @retval  EFI_SUCCESS       Update the disk index info success.\r
\r
**/\r
EFI_STATUS\r
HiiSelectDisk(\r
  UINT8 Index\r
  );\r
\r
/**\r
  Use the input password to do the specified action.\r
\r
  @param      Str            The input password saved in.\r
\r
  @retval  EFI_SUCCESS       Do the required action success.\r
  @retval  Others            Other error occur.\r
\r
**/\r
EFI_STATUS\r
HiiPasswordEntered(\r
  EFI_STRING_ID            Str\r
  );\r
\r
/**\r
  Update block sid info.\r
\r
  @param      Enable         Enable/disable BlockSid.\r
\r
  @retval  EFI_SUCCESS       Do the required action success.\r
  @retval  Others            Other error occur.\r
\r
**/\r
EFI_STATUS\r
HiiSetBlockSid (\r
  BOOLEAN          Enable\r
  );\r
\r
/**\r
  Reverts the Opal disk to factory default.\r
\r
  @retval  EFI_SUCCESS       Do the required action success.\r
\r
**/\r
EFI_STATUS\r
HiiPsidRevert(\r
  VOID\r
  );\r
\r
/**\r
  Get disk name string id.\r
\r
  @param   DiskIndex             The input disk index info.\r
\r
  @retval  The disk name string id.\r
\r
**/\r
EFI_STRING_ID\r
GetDiskNameStringId(\r
  UINT8 DiskIndex\r
  );\r
\r
/**\r
  Update the device info.\r
\r
  @param OpalDisk                The Opal device.\r
\r
  @retval EFI_SUCESS             Initialize the device success.\r
  @retval EFI_DEVICE_ERROR       Get info from device failed.\r
  @retval EFI_INVALID_PARAMETER  Not get Msid info before get ownership info.\r
\r
**/\r
EFI_STATUS\r
OpalDiskUpdateStatus (\r
  OPAL_DISK        *OpalDisk\r
  );\r
\r
#pragma pack()\r
\r
#endif // _HII_P_H_\r