/** @file\r
Provides interface to advanced shell functionality for parsing both handle and protocol database.\r
\r
- Copyright (c) 2010, Intel Corporation. All rights reserved.<BR>\r
+ Copyright (c) 2010 - 2014, 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
\r
#include <Uefi.h>\r
\r
+/**\r
+ Function to add a new GUID/Name mapping.\r
+\r
+ This cannot overwrite an existing mapping.\r
+\r
+ @param[in] Guid The Guid\r
+ @param[in] TheName The Guid's name\r
+ @param[in] Lang RFC4646 language code list or NULL\r
+\r
+ @retval EFI_SUCCESS The operation was sucessful\r
+ @retval EFI_ACCESS_DENIED There was a duplicate\r
+ @retval EFI_OUT_OF_RESOURCES A memory allocation failed\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+AddNewGuidNameMapping(\r
+ IN CONST EFI_GUID *Guid,\r
+ IN CONST CHAR16 *TheName,\r
+ IN CONST CHAR8 *Lang OPTIONAL\r
+ );\r
+\r
/**\r
Function to get the name of a protocol or struct from it's GUID.\r
\r
/**\r
Function to get the Guid for a protocol or struct based on it's string name.\r
\r
+ Do not free or modify the returned GUID.\r
+\r
@param[in] Name The pointer to the string name.\r
@param[in] Lang The pointer to the language code (string).\r
- @param[in] Guid The pointer to the pointer to the Guid.\r
+ @param[out] Guid The pointer to the pointer to the Guid.\r
\r
@retval EFI_SUCCESS The operation was successful.\r
**/\r
GetGuidFromStringName(\r
IN CONST CHAR16 *Name,\r
IN CONST CHAR8 *Lang OPTIONAL,\r
- IN EFI_GUID **Guid\r
+ OUT EFI_GUID **Guid\r
);\r
\r
/**\r
IN CONST CHAR8 *Language\r
);\r
\r
+/**\r
+ Get best support language for this driver.\r
+ \r
+ First base on the user input language to search, second base on the current \r
+ platform used language to search, third get the first language from the \r
+ support language list. The caller need to free the buffer of the best language.\r
+\r
+ @param[in] SupportedLanguages The support languages for this driver.\r
+ @param[in] InputLanguage The user input language.\r
+ @param[in] Iso639Language Whether get language for ISO639.\r
+\r
+ @return The best support language for this driver.\r
+**/\r
+CHAR8 *\r
+EFIAPI\r
+GetBestLanguageForDriver (\r
+ IN CONST CHAR8 *SupportedLanguages,\r
+ IN CONST CHAR8 *InputLanguage,\r
+ IN BOOLEAN Iso639Language\r
+ );\r
+\r
#define HR_UNKNOWN 0\r
#define HR_IMAGE_HANDLE BIT1\r
#define HR_DRIVER_BINDING_HANDLE BIT2 // has driver binding\r
**/\r
EFI_HANDLE*\r
EFIAPI\r
-GetHandleListByPotocol (\r
+GetHandleListByProtocol (\r
IN CONST EFI_GUID *ProtocolGuid OPTIONAL\r
);\r
\r
@param[in] ProtocolGuids A NULL terminated list of protocol GUIDs.\r
\r
@retval NULL A memory allocation failed.\r
- @return A NULL terminated list of handles.\r
+ @retval NULL ProtocolGuids was NULL.\r
+ @return A NULL terminated list of EFI_HANDLEs.\r
**/\r
EFI_HANDLE*\r
EFIAPI\r
-GetHandleListByPotocolList (\r
+GetHandleListByProtocolList (\r
IN CONST EFI_GUID **ProtocolGuids\r
);\r
\r