From 515575f737f2d4aa3baff75649842f87fd8d5dd0 Mon Sep 17 00:00:00 2001 From: Eric Dong Date: Mon, 23 Nov 2015 05:42:21 +0000 Subject: [PATCH] MdeModulePkg FileExplorerDxe: Create file explorer Protocol. This driver produces file explorer protocol layered on top of the FileExplorerLib. Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Eric Dong Reviewed-by: Liming Gao Reviewed-by: Samer El-Haj-Mahmoud git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18918 6f19259b-4bc3-4df7-8a09-765794883524 --- MdeModulePkg/Include/Protocol/FileExplorer.h | 75 ++++++++++++++++++ MdeModulePkg/MdeModulePkg.dec | 3 + MdeModulePkg/MdeModulePkg.dsc | 4 + .../FileExplorerDxe/FileExplorerDxe.c | 58 ++++++++++++++ .../FileExplorerDxe/FileExplorerDxe.inf | 53 +++++++++++++ .../FileExplorerDxe/FileExplorerDxe.uni | Bin 0 -> 2038 bytes .../FileExplorerDxe/FileExplorerDxeExtra.uni | Bin 0 -> 1362 bytes 7 files changed, 193 insertions(+) create mode 100644 MdeModulePkg/Include/Protocol/FileExplorer.h create mode 100644 MdeModulePkg/Universal/FileExplorerDxe/FileExplorerDxe.c create mode 100644 MdeModulePkg/Universal/FileExplorerDxe/FileExplorerDxe.inf create mode 100644 MdeModulePkg/Universal/FileExplorerDxe/FileExplorerDxe.uni create mode 100644 MdeModulePkg/Universal/FileExplorerDxe/FileExplorerDxeExtra.uni diff --git a/MdeModulePkg/Include/Protocol/FileExplorer.h b/MdeModulePkg/Include/Protocol/FileExplorer.h new file mode 100644 index 0000000000..2831966edf --- /dev/null +++ b/MdeModulePkg/Include/Protocol/FileExplorer.h @@ -0,0 +1,75 @@ +/** @file + + This file explorer protocol defines defines a set of interfaces for + how to do file explorer. + +Copyright (c) 2006 - 2015, 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 that accompanies this distribution. +The full text of the license may be found at +http://opensource.org/licenses/bsd-license.php. + +THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, +WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. + +**/ + +#ifndef __FILE_EXPLORER_H__ +#define __FILE_EXPLORER_H__ + +#define EFI_FILE_EXPLORER_PROTOCOL_GUID \ + { 0x2C03C536, 0x4594, 0x4515, { 0x9E, 0x7A, 0xD3, 0xD2, 0x04, 0xFE, 0x13, 0x63 } } + +// +// Forward reference for pure ANSI compatability +// +typedef struct _EFI_FILE_EXPLORER_PROTOCOL EFI_FILE_EXPLORER_PROTOCOL; + +/** + Prototype for the next process after user chosed one file. + + @param[in] FilePath The device path of the find file. + + @retval TRUE Need exit file explorer after do the extra task. + @retval FALSE Not need to exit file explorer after do the extra task. + +**/ +typedef +BOOLEAN +(EFIAPI *CHOOSE_HANDLER)( + IN EFI_DEVICE_PATH_PROTOCOL *FilePath + ); + +/** + Choose a file in the specified directory. + + If user input NULL for the RootDirectory, will choose file in the system. + + If user input *File != NULL, function will return the allocate device path + info for the choosed file, caller has to free the memory after use it. + + @param RootDirectory Pointer to the root directory. + @param FileType The file type need to choose. + @param ChooseHandler Function pointer to the extra task need to do + after choose one file. + @param File Return the device path for the last time chosed file. + + @retval EFI_SUCESS Choose the file success. + @retval Other errors Choose the file failed. +**/ +typedef +EFI_STATUS +(EFIAPI *CHOOSE_FILE) ( + IN EFI_DEVICE_PATH_PROTOCOL *RootDirectory, + IN CHAR16 *FileType, OPTIONAL + IN CHOOSE_HANDLER ChooseHandler, OPTIONAL + OUT EFI_DEVICE_PATH_PROTOCOL **File OPTIONAL + ); + +struct _EFI_FILE_EXPLORER_PROTOCOL { + CHOOSE_FILE ChooseFile; +}; + +extern EFI_GUID gEfiFileExplorerProtocolGuid; + +#endif diff --git a/MdeModulePkg/MdeModulePkg.dec b/MdeModulePkg/MdeModulePkg.dec index 5d3258d020..6b32ec19ef 100644 --- a/MdeModulePkg/MdeModulePkg.dec +++ b/MdeModulePkg/MdeModulePkg.dec @@ -464,6 +464,9 @@ ## Include/Protocol/PlatformLogo.h gEdkiiPlatformLogoProtocolGuid = { 0x9b517978, 0xeba1, 0x44e7, { 0xba, 0x65, 0x7c, 0x2c, 0xd0, 0x8b, 0xf8, 0xe9 } } + ## Include/Protocol/FileExplorer.h + gEfiFileExplorerProtocolGuid = { 0x2C03C536, 0x4594, 0x4515, { 0x9E, 0x7A, 0xD3, 0xD2, 0x04, 0xFE, 0x13, 0x63 } } + # # [Error.gEfiMdeModulePkgTokenSpaceGuid] # 0x80000001 | Invalid value provided. diff --git a/MdeModulePkg/MdeModulePkg.dsc b/MdeModulePkg/MdeModulePkg.dsc index 7447be731e..a1fd719809 100644 --- a/MdeModulePkg/MdeModulePkg.dsc +++ b/MdeModulePkg/MdeModulePkg.dsc @@ -375,6 +375,10 @@ MdeModulePkg/Universal/EsrtDxe/EsrtDxe.inf MdeModulePkg/Universal/PropertiesTableAttributesDxe/PropertiesTableAttributesDxe.inf + MdeModulePkg/Universal/FileExplorerDxe/FileExplorerDxe.inf { + + FileExplorerLib|MdeModulePkg/Library/FileExplorerLib/FileExplorerLib.inf + } [Components.IA32, Components.X64, Components.IPF] MdeModulePkg/Universal/Network/UefiPxeBcDxe/UefiPxeBcDxe.inf diff --git a/MdeModulePkg/Universal/FileExplorerDxe/FileExplorerDxe.c b/MdeModulePkg/Universal/FileExplorerDxe/FileExplorerDxe.c new file mode 100644 index 0000000000..93a6f98b67 --- /dev/null +++ b/MdeModulePkg/Universal/FileExplorerDxe/FileExplorerDxe.c @@ -0,0 +1,58 @@ +/** @file + This driver produces file explorer protocol layered on top of the FileExplorerLib from the MdeModulePkg. + +Copyright (c) 2015, 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 + +THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, +WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. + +**/ + +#include + +#include +#include +#include +#include +#include + +EFI_HANDLE mFileExplorerThunkHandle = NULL; + +CONST EFI_FILE_EXPLORER_PROTOCOL mFileExplorerProtocol = { + ChooseFile +}; + +/** + The user Entry Point for File explorer module. + + This is the entry point for Print DXE Driver. It installs the file explorer Protocol. + + @param[in] ImageHandle The firmware allocated handle for the EFI image. + @param[in] SystemTable A pointer to the EFI System Table. + + @retval EFI_SUCCESS The entry point is executed successfully. + @retval Others Some error occurs when executing this entry point. + +**/ +EFI_STATUS +EFIAPI +FileExplorerEntryPoint ( + IN EFI_HANDLE ImageHandle, + IN EFI_SYSTEM_TABLE *SystemTable + ) +{ + EFI_STATUS Status; + + Status = gBS->InstallMultipleProtocolInterfaces ( + &mFileExplorerThunkHandle, + &gEfiFileExplorerProtocolGuid, &mFileExplorerProtocol, + NULL + ); + ASSERT_EFI_ERROR (Status); + + return Status; +} diff --git a/MdeModulePkg/Universal/FileExplorerDxe/FileExplorerDxe.inf b/MdeModulePkg/Universal/FileExplorerDxe/FileExplorerDxe.inf new file mode 100644 index 0000000000..81ccab9b98 --- /dev/null +++ b/MdeModulePkg/Universal/FileExplorerDxe/FileExplorerDxe.inf @@ -0,0 +1,53 @@ +## @file +# File explorer DXE driver that produces File explorer Protocol. +# +# This driver produces File explorerprotocol layered on top of the FileExplorerLib +# from the MdeModulePkg. +# +# Copyright (c) 2009 - 2015, 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 +# +# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, +# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. +# +## + +[Defines] + INF_VERSION = 0x00010005 + BASE_NAME = FileExplorerDxe + MODULE_UNI_FILE = FileExplorerDxe.uni + FILE_GUID = 405DA936-3737-4C0C-8E3F-E6172A568592 + MODULE_TYPE = DXE_DRIVER + VERSION_STRING = 1.0 + ENTRY_POINT = FileExplorerEntryPoint + +# +# The following information is for reference only and not required by the build tools. +# +# VALID_ARCHITECTURES = IA32 X64 IPF EBC +# + +[Sources] + FileExplorerDxe.c + +[Packages] + MdeModulePkg/MdeModulePkg.dec + MdePkg/MdePkg.dec + +[LibraryClasses] + FileExplorerLib + UefiBootServicesTableLib + UefiDriverEntryPoint + DebugLib + +[Protocols] + gEfiFileExplorerProtocolGuid ## PRODUCES + +[Depex] + TRUE + +[UserExtensions.TianoCore."ExtraFiles"] + FileExplorerDxeExtra.uni diff --git a/MdeModulePkg/Universal/FileExplorerDxe/FileExplorerDxe.uni b/MdeModulePkg/Universal/FileExplorerDxe/FileExplorerDxe.uni new file mode 100644 index 0000000000000000000000000000000000000000..010274b8250c1adf9426965a1d19fb500fddd089 GIT binary patch literal 2038 zcmb`IUvCmo5XI-&#P4uJU(~dqO?=Q8BiOAHZ6QEYeKJs5*htxi(ptW}`a84#fFf$r zY-TAA1|q z)Vqunh}O4-Gd_o5ApVr6Jg$6p;j=Lw+clWLZa`Lj?nS{rprmrYTtYb_&bb|7l_FBP zZQpIQG3)ovW8rFzP(W%vL8Yg>_w6~?D@J?S?1jCwUB*pvn1efEEQA@k=&5SNjHbj2 zR%cxvs#%Jy%BZH-+%vD^5YIQ(u#UYga@tgrRM(NmP_BJqNKN&Cl+eWXM}?aB-q)}_ybeO}>Ga{b}`dB*d8wlN%pC=PiK>pl0Z2k>03OEC4i_+NN` zs77La$8(+4sxqmX3%mx|_erLKIL()oRVU4<#cSW)>h)Az`OjSID*4Z-P;E{9Yb*n} z59zwq=v7e0+@&VvsAnJj57DNRTK0iwogJV~?eaYEcMofmUOOTG$hAJPW8M*VX_6w8 zb!gJt5guJfZZT3%>sjF~T%lKZH+-(y?h?CG)`i;gh`~NvAw>`hRG(emgWX5ucJ zV)pQrkD{hthxjV`SKgmk5p(UuD2tM25%H(YaZ2*J?wz84 z(tXs0PshH2)B@uKw1`=q+|!jhYW3jrr)$S|j<9a%m67+4dSVYOF|9oC39#)itOJ-d9m-9LBoGc)*JT|FTm=G<97dG#+EP@Dfb IV@fT51L+JyEdT%j literal 0 HcmV?d00001 diff --git a/MdeModulePkg/Universal/FileExplorerDxe/FileExplorerDxeExtra.uni b/MdeModulePkg/Universal/FileExplorerDxe/FileExplorerDxeExtra.uni new file mode 100644 index 0000000000000000000000000000000000000000..a4255e90b26c83a25047494c6bf45d5d70b4b1f5 GIT binary patch literal 1362 zcmZXUTW{Jx5QXQtQvZWRUfL=#y{Io$RTYZUT1_w_pr%iexrA5(j0{aee|(egtnGD3 zg}ggEGkfOj*i%*xv13*bSM1y#oC;^Lu-1@9YEC ziC=xRW9+!XTw<$20Z)x7`!iQDB+`MQGQ_LI7Bih?%U9T~;~v^)>)O!1cm*1EBN%1w zJR9Y|m`S%9U%O{j zg#{W;7 z!9j@PQ0k>xTh==D1fEatB{1nK{?|mxI}+=AvYxX#RHjsOPu8T`pH~`))9#6~>ZBca z@yYdcj#a9w{K9D+a{huFZ9h|gi)RA&8C`c+Jp|>3uhyiVb)FvJsCH9@MW9O`6 zG!0Ny^9XNDr;V{9r}WtR%n|+up}B>a&W^~qaL5UkI$C3kS-3)NF?Zcst7FeCuwTT* zD{&RI?odh0`uJl|g^{@GLssH0pK6ZCQjV&YS*PS`=WphpM8sVG#HgxLo+7eKkJF&X zXfdF#RI_KH=h*0{x2Wy>@*Vlk(QBf&McQ3e>JC5|`V(A%oq#$9KO(0O%X6&2p&fC9 r`VTC)^^{RPr#?6#U;I?9<=;D<=J3VS-Ca7gp6g`27zI1Dul^nZQ*P0^ literal 0 HcmV?d00001