Tools/Source/TianoTools/Include/Protocol/LoadFile.h

   1 /** @file
   2   Load File protocol as defined in the EFI 1.0 specification.
   3
   4   Load file protocol exists to supports the addition of new boot devices,
   5   and to support booting from devices that do not map well to file system.
   6   Network boot is done via a LoadFile protocol.
   7
   8   EFI 1.0 can boot from any device that produces a LoadFile protocol.
   9
  10   Copyright (c) 2006, Intel Corporation
  11   All rights reserved. This program and the accompanying materials
  12   are licensed and made available under the terms and conditions of the BSD License
  13   which accompanies this distribution.  The full text of the license may be found at
  14   http://opensource.org/licenses/bsd-license.php
  15
  16   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  17   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  18
  19   Module Name:  LoadFile.h
  20
  21 **/
  22
  23 #ifndef __EFI_LOAD_FILE_PROTOCOL_H__
  24 #define __EFI_LOAD_FILE_PROTOCOL_H__
  25
  26 #define LOAD_FILE_PROTOCOL_GUID \
  27   { \
  28     0x56EC3091, 0x954C, 0x11d2, {0x8E, 0x3F, 0x00, 0xA0, 0xC9, 0x69, 0x72, 0x3B } \
  29   }
  30
  31 //
  32 // Protocol Guid Name defined by UEFI 2.0 spec.
  33 //
  34 #define EFI_LOAD_FILE_PROTOCOL_GUID LOAD_FILE_PROTOCOL_GUID
  35
  36 typedef struct _EFI_LOAD_FILE_PROTOCOL EFI_LOAD_FILE_PROTOCOL;
  37
  38 /**
  39   Causes the driver to load a specified file.
  40
  41   @param  This       Protocol instance pointer.
  42   @param  FilePath   The device specific path of the file to load.
  43   @param  BootPolicy If TRUE, indicates that the request originates from the
  44                      boot manager is attempting to load FilePath as a boot
  45                      selection. If FALSE, then FilePath must match as exact file
  46                      to be loaded.
  47   @param  BufferSize On input the size of Buffer in bytes. On output with a return
  48                      code of EFI_SUCCESS, the amount of data transferred to
  49                      Buffer. On output with a return code of EFI_BUFFER_TOO_SMALL,
  50                      the size of Buffer required to retrieve the requested file.
  51   @param  Buffer     The memory buffer to transfer the file to. IF Buffer is NULL,
  52                      then no the size of the requested file is returned in
  53                      BufferSize.
  54
  55   @retval EFI_SUCCESS           The file was loaded.
  56   @retval EFI_UNSUPPORTED       The device does not support the provided BootPolicy
  57   @retval EFI_INVALID_PARAMETER FilePath is not a valid device path, or
  58                                 BufferSize is NULL.
  59   @retval EFI_NO_MEDIA          No medium was present to load the file.
  60   @retval EFI_DEVICE_ERROR      The file was not loaded due to a device error.
  61   @retval EFI_NO_RESPONSE       The remote system did not respond.
  62   @retval EFI_NOT_FOUND         The file was not found
  63   @retval EFI_ABORTED           The file load process was manually cancelled.
  64
  65 **/
  66 typedef
  67 EFI_STATUS
  68 (EFIAPI *EFI_LOAD_FILE) (
  69   IN EFI_LOAD_FILE_PROTOCOL           *This,
  70   IN EFI_DEVICE_PATH_PROTOCOL         *FilePath,
  71   IN BOOLEAN                          BootPolicy,
  72   IN OUT UINTN                        *BufferSize,
  73   IN VOID                             *Buffer OPTIONAL
  74   )
  75 ;
  76
  77 struct _EFI_LOAD_FILE_PROTOCOL {
  78   EFI_LOAD_FILE LoadFile;
  79 };
  80
  81 extern EFI_GUID gEfiLoadFileProtocolGuid;
  82
  83 #endif