Efi_File_Io_Interface.openvolume() - Intel Extensible Firmware Interface Specification

10.1.1 EFI_FILE_IO_INTERFACE.OpenVolume()

Summary
Opens the root directory on a volume.
Prototype
typedef
EFI_STATUS
(EFIAPI *EFI_VOLUME_OPEN) (
IN EFI_FILE_IO_INTERFACE
OUT EFI_FILE
);
Parameters
This
Root
Description
The
OpenVolume()
directory. This handle is used to perform all other file I/O operations. The volume remains open
until all the file handles to it are closed.
If the medium is changed while there are open file handles to the volume, all file handles to the
volume will return EFI_MEDIA_CHANGED. To access the files on the new medium, the volume
must be re-opened with OpenVolume(). If the new medium is a different file system than the
one supplied in the
will return EFI_UNSUPPORTED.
OpenVolume()
Status Codes Returned
EFI_SUCCESS
EFI_UNSUPPORTED
EFI_NO_MEDIA
EFI_DEVICE_ERROR
EFI_VOLUME_CORRUPTED
EFI_ACCESS_DENIED
EFI_OUT_OF_RESOURCES
Version 1.02
A pointer to the volume to open the root directory of. Type
EFI_FILE_IO_INTERFACE
A pointer to the location to return the opened file handle for the root
directory. Type
EFI_FILE
function opens a volume, and returns a file handle to the volume's root
EFI_HANDLE's DevicePath
The file volume was opened.
The volume does not support the requested file system type.
The device has no medium.
The device reported an error.
The file system structures are corrupted.
The service denied access to the file.
The file volume was not opened.
*This,
**Root
is defined in Section 10.1.
is defined in Section 10.2.
for the Simple File System protocol,
12/12/00
File System Protocol
189