Struct uefi::proto::media::file::NamedFileProtocolInfo

source [−]

#[repr(C)]
pub struct NamedFileProtocolInfo<Header> { /* private fields */ }

Expand description

Dynamically sized FileProtocolInfo with a header and an UCS-2 name

All structs that can currently be queried via Get/SetInfo can be described as a (possibly empty) header followed by a variable-sized name.

Since such dynamic-sized types are a bit unpleasant to handle in Rust today, this generic struct was created to deduplicate the relevant code.

The reason why this struct covers the whole DST, as opposed to the [Char16] part only, is that pointers to DSTs are created in a rather unintuitive way that is best kept centralized in one place.

Implementations

source

impl NamedFileProtocolInfo<FileInfoHeader>

source

pub fn new<'buf>(
    storage: &'buf mut [u8 ],
    file_size: u64,
    physical_size: u64,
    create_time: Time,
    last_access_time: Time,
    modification_time: Time,
    attribute: FileAttribute,
    file_name: &str
) -> Result<&'buf mut Self, FileInfoCreationError>

Create a FileInfo structure

The structure will be created in-place within the provided storage buffer. The buffer must be large enough to hold the data structure, including a null-terminated UCS-2 version of the name string.

The buffer must be correctly aligned. You can query the required alignment using the alignment() method of the Align trait that this struct implements.

source

pub fn file_size(&self) -> u64

File size (number of bytes stored in the file)

source

pub fn physical_size(&self) -> u64

Physical space consumed by the file on the file system volume

source

pub fn create_time(&self) -> &Time

Time when the file was created

source

pub fn last_access_time(&self) -> &Time

Time when the file was last accessed

source

pub fn modification_time(&self) -> &Time

Time when the file’s contents were last modified

source

pub fn attribute(&self) -> FileAttribute

Attribute bits for the file

source

pub fn file_name(&self) -> &CStr16

Name of the file

source

impl NamedFileProtocolInfo<FileSystemInfoHeader>

source

pub fn new<'buf>(
    storage: &'buf mut [u8 ],
    read_only: bool,
    volume_size: u64,
    free_space: u64,
    block_size: u32,
    volume_label: &str
) -> Result<&'buf mut Self, FileInfoCreationError>

Create a FileSystemInfo structure

The structure will be created in-place within the provided storage buffer. The buffer must be large enough to hold the data structure, including a null-terminated UCS-2 version of the name string.

The buffer must be correctly aligned. You can query the required alignment using the alignment() method of the Align trait that this struct implements.

source

pub fn read_only(&self) -> bool

Truth that the volume only supports read access

source

pub fn volume_size(&self) -> u64

Number of bytes managed by the file system

source

pub fn free_space(&self) -> u64

Number of available bytes for use by the file system

source

pub fn block_size(&self) -> u32

Nominal block size by which files are typically grown

source

pub fn volume_label(&self) -> &CStr16

Volume label

source

impl NamedFileProtocolInfo<FileSystemVolumeLabelHeader>

source

pub fn new<'buf>(
storage: &'buf mut [u8 ],
volume_label: &str
) -> Result<&'buf mut Self, FileInfoCreationError>

Create a FileSystemVolumeLabel structure

The structure will be created in-place within the provided storage buffer. The buffer must be large enough to hold the data structure, including a null-terminated UCS-2 version of the name string.

The buffer must be correctly aligned. You can query the required alignment using the alignment() method of the Align trait that this struct implements.

source