Struct uefi::proto::media::file::FileHandle

#[repr(transparent)]
pub struct FileHandle(_);

An opaque handle to some contiguous block of data on a volume.

A FileHandle is just a wrapper around a UEFI file handle. Under the hood, it can either be a RegularFile or a Directory; use the into_type() or the unsafe {RegularFile, Directory}::new() methods to perform the conversion.

Dropping this structure will result in the file handle being closed.

Implementations

impl FileHandle

pub fn into_type(self) -> Result<FileType>

Converts File into a more specific subtype based on if it is a directory or not. It does this via a call to get_position.

Trait Implementations

impl Drop for FileHandle

fn drop(&mut self)

Executes the destructor for this type.

impl File for FileHandle

fn open(
    &mut self,
    filename: &CStr16,
    open_mode: FileMode,
    attributes: FileAttribute
) -> Result<FileHandle>

Try to open a file relative to this file.

fn close(self)

Close this file handle. Same as dropping this structure.

fn delete(self) -> Result

Closes and deletes this file

fn get_info<'buf, Info: FileProtocolInfo + ?Sized>(
    &mut self,
    buffer: &'buf mut [u8]
) -> Result<&'buf mut Info, Option<usize>>

Queries some information about a file

fn set_info<Info: FileProtocolInfo + ?Sized>(&mut self, info: &Info) -> Result

Sets some information about a file

fn flush(&mut self) -> Result

Flushes all modified data associated with the file handle to the device

fn get_boxed_info<Info: FileProtocolInfo + ?Sized>(
    &mut self
) -> Result<Box<Info>>

Get the dynamically allocated info for a file