REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3760 Update all use of ', OPTIONAL' to ' OPTIONAL,' for function params. Cc: Andrew Fish <afish@apple.com> Cc: Leif Lindholm <leif@nuviainc.com> Cc: Michael Kubacki <michael.kubacki@microsoft.com> Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com> Reviewed-by: Liming Gao <gaoliming@byosoft.com.cn>
		
			
				
	
	
		
			42 lines
		
	
	
		
			1.3 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			42 lines
		
	
	
		
			1.3 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /** @file
 | |
| 
 | |
|   This library class defines a set of interfaces for how to do file explorer.
 | |
| 
 | |
| Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>
 | |
| SPDX-License-Identifier: BSD-2-Clause-Patent
 | |
| 
 | |
| **/
 | |
| 
 | |
| #ifndef __FILE_EXPLORER_LIB_H__
 | |
| #define __FILE_EXPLORER_LIB_H__
 | |
| 
 | |
| #include <Protocol/FileExplorer.h>
 | |
| 
 | |
| /**
 | |
|   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
 |