Struct cannyls::device::DeviceHandle

pub struct DeviceHandle(_);

デバイスを操作するためのハンドル.

Methods

impl DeviceHandle

pub fn request(&self) -> DeviceRequest

デバイスの発行するリクエストのビルダを返す.

pub fn metrics(&self) -> &Arc<DeviceMetrics>

デバイスのメトリクスを返す.

pub fn allocate_lump_data(&self, size: usize) -> Result<LumpData>

ストレージのブロック境界にアライメントされたメモリ領域を保持するLumpDataインスタンスを返す.

LumpData::new関数に比べて、このメソッドが返したLumpDataインスタンスは、 デバイスが管理しているストレージのブロック境界に合わせたアライメントが行われているため、 ストレージへのPUT時に余計なメモリコピーが発生することがなく、より効率的となる.

注意

このメソッドが返したLumpDataインスタンスを、別の(ブロックサイズが異なる)ストレージに 保存しようとした場合には、エラーが発生する.

Errors

指定されたサイズがMAX_SIZEを超えている場合は、ErrorKind::InvalidInputエラーが返される.

pub fn allocate_lump_data_with_bytes(&self, bytes: &[u8]) -> Result<LumpData>

allocate_lump_dataメソッドにデータの初期化を加えたメソッド.

このメソッドの呼び出しは、以下のコードと等価となる:

let mut data = track!(self.allocate_lump_data(bytes.len()))?;
data.as_bytes_mut().copy_from_slice(bytes);

詳細な挙動に関してはallocate_lump_dataのドキュメントを参照のこと.

Trait Implementations

impl Clone for DeviceHandle

fn clone(&self) -> DeviceHandle

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DeviceHandle

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.