MdeModulePkg/NetLib: Add NetLibDetectMediaWaitTimeout() API to support EFI_NOT_READY...

[mirror_edk2.git] / MdeModulePkg / Include / Library / FileExplorerLib.h

/** @file\r
\r
  This library class defines a set of interfaces for how to do file explorer.\r
\r
Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.<BR>\r
This program and the accompanying materials are licensed and made available under \r
the terms and conditions of the BSD License that accompanies this distribution.  \r
The full text of the license may be found at\r
http://opensource.org/licenses/bsd-license.php.                                            \r
\r
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     \r
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
**/\r
\r
#ifndef __FILE_EXPLORER_LIB_H__\r
#define __FILE_EXPLORER_LIB_H__\r
\r
#include <Protocol/FileExplorer.h>\r
\r
/**\r
  Choose a file in the specified directory. \r
\r
  If user input NULL for the RootDirectory, will choose file in the system.\r
\r
  If user input *File != NULL, function will return the allocate device path\r
  info for the choosed file, caller has to free the memory after use it.\r
\r
  @param  RootDirectory    Pointer to the root directory.\r
  @param  FileType         The file type need to choose.\r
  @param  ChooseHandler    Function pointer to the extra task need to do\r
                           after choose one file.\r
  @param  File             Return the device path for the last time chosed file.\r
\r
  @retval EFI_SUCESS       Choose the file success.\r
  @retval Other errors     Choose the file failed.\r
**/\r
EFI_STATUS\r
EFIAPI\r
ChooseFile (\r
  IN  EFI_DEVICE_PATH_PROTOCOL  *RootDirectory,\r
  IN  CHAR16                    *FileType,  OPTIONAL\r
  IN  CHOOSE_HANDLER            ChooseHandler,  OPTIONAL\r
  OUT EFI_DEVICE_PATH_PROTOCOL  **File  OPTIONAL\r
  );\r
\r
#endif\r