Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Eric Dong <eric.dong@intel.com> Reviewed-by: Liming Gao <liming.gao@intel.com> git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19294 6f19259b-4bc3-4df7-8a09-765794883524
		
			
				
	
	
		
			61 lines
		
	
	
		
			2.0 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			61 lines
		
	
	
		
			2.0 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /** @file
 | |
| 
 | |
|   This library class defines a set of interfaces for how to do file explorer.
 | |
| 
 | |
| Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.<BR>
 | |
| 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_LIB_H__
 | |
| #define __FILE_EXPLORER_LIB_H__
 | |
| 
 | |
| /**
 | |
|   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.
 | |
| **/
 | |
| EFI_STATUS
 | |
| EFIAPI
 | |
| ChooseFile (
 | |
|   IN  EFI_DEVICE_PATH_PROTOCOL  *RootDirectory,
 | |
|   IN  CHAR16                    *FileType,  OPTIONAL
 | |
|   IN  CHOOSE_HANDLER            ChooseHandler,  OPTIONAL
 | |
|   OUT EFI_DEVICE_PATH_PROTOCOL  **File  OPTIONAL
 | |
|   );
 | |
| 
 | |
| #endif
 |