ba529e7e5a
This library support select one file from the specified directory or from system root directory. Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Eric Dong <eric.dong@intel.com> Reviewed-by: Liming Gao <liming.gao@intel.com> Reviewed-by: Samer El-Haj-Mahmoud <elhaj@hpe.com> git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18917 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
|