Intel Extensible Firmware Interface, Specification

Page: 224 / 494

Extensible Firmware Interface Specification
206 12/12/00 Version 1.02
10.2.12 EFI_FILE_SYSTEM_INFO
Summary
Provides a GUID and a data structure that can be used with
EFI_FILE.GetInfo()
to get
information about the system volume, and
EFI_FILE.SetInfo()
to set the system volume’s
volume label.
GUID
#define EFI_FILE_SYSTEM_INFO_ID \
{ 09576e93-6d3f-11d2-8e39-00a0c969723b }
Related Definitions
typedef struct {
UINT64 Size ;
BOOLEAN ReadOnly ;
UINT64
VolumeSize ;
UINT64 FreeSpace ;
UINT32 BlockSize ;
CHAR16
VolumeLabel[] ;
} EFI_FILE_SYSTEM_INFO;
Parameters
Size
Size of the
EFI_FILE_SYSTEM_INFO
structure, including the Null-
terminated Unicode
VolumeLabel
string.
ReadOnly TRUE
if the volume only supports read access.
VolumeSize
The number of bytes managed by the file system.
FreeSpace
The number of available bytes for use by the file system.
BlockSize
The nominal block size files are typically grown by.
VolumeLabel
The Null-terminated string that is the volume’s label.
Description
The
EFI_FILE_SYSTEM_INFO
data structure is an information structure that can be obtained on
the root directory file handle. The root directory file handle is the file handle first obtained on the
initial call to the
HandleProtocol()
function to open the file system interface. All of the
fields are read-only except for
VolumeLabel
. The system volume’s
VolumeLabel
can be
created or modified by calling
EFI_FILE.SetInfo()
with an updated
VolumeLabel
field.