Struct DBuff 

pub struct DBuff { /* private fields */ }

Methods from Deref<Target = DArray<u8>>

pub fn dma_addr(&self) -> DmaAddr

获取 DMA 地址。

返回设备用于访问此 DMA 缓冲区的物理/DMA 地址。 将此地址传递给硬件设备以配置 DMA 操作。

返回

DMA 地址

pub fn len(&self) -> usize

获取数组长度（元素个数）。

返回

数组中的元素个数

pub fn is_empty(&self) -> bool

检查数组是否为空。

返回

如果数组长度为 0 返回 true，否则返回 false

pub fn bytes_len(&self) -> usize

获取数组的字节长度。

返回

数组占用的总字节数

pub fn read(&self, index: usize) -> Option<T>

读取指定索引的元素。

根据 DMA 方向自动处理缓存同步：

• FromDevice/Bidirectional: 读取前使 CPU 缓存失效
• ToDevice: 无缓存操作

参数

• index: 元素索引

返回

如果索引有效返回 Some(T)，否则返回 None

pub fn set(&mut self, index: usize, value: T)

设置指定索引的元素值。

根据 DMA 方向自动处理缓存同步：

• ToDevice/Bidirectional: 写入后刷新 CPU 缓存
• FromDevice: 无缓存操作

参数

• index: 元素索引，必须在范围内
• value: 要写入的值

Panics

如果 index >= self.len() 则 panic

pub fn iter(&self) -> DArrayIter<'_, T>

创建迭代器。

返回一个迭代器，按顺序读取数组元素。 每次读取都会自动处理缓存同步。

返回

DArrayIter 迭代器

pub fn copy_from_slice(&mut self, src: &[T])

从 slice 复制数据到数组。

复制完成后刷新整个数组的 CPU 缓存（ToDevice/Bidirectional）。

参数

• src: 源 slice，长度必须 <= self.len()

Panics

如果 src.len() > self.len() 则 panic

pub fn prepare_read(&self, offset: usize, size: usize)

在 CPU 读取前同步指定字节范围。

对 FromDevice 和 Bidirectional 方向，这会使对应缓存范围失效。

pub fn confirm_write(&self, offset: usize, size: usize)

在设备读取前同步指定字节范围。

对 ToDevice 和 Bidirectional 方向，这会将对应缓存范围刷回内存。

pub fn prepare_read_all(&self)

在 CPU 读取前同步整个数组。

pub fn confirm_write_all(&self)

在设备读取前同步整个数组。

pub fn write_with<R>(&mut self, len: usize, f: impl FnOnce(&mut [T]) -> R) -> R

直接借出一段可写切片，并在闭包返回后自动同步缓存。

pub fn read_with<R>(&self, len: usize, f: impl FnOnce(&[T]) -> R) -> R

直接借出一段只读切片，并在闭包调用前自动同步缓存。

pub unsafe fn as_mut_slice(&mut self) -> &mut [T]

Safety

slice will not auto do cache sync operations.

pub fn as_ptr(&self) -> NonNull<T>

Trait Implementations

impl Deref for DBuff

type Target = DArray<u8>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for DBuff

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl Drop for DBuff

fn drop(&mut self)

Executes the destructor for this type.

impl Send for DBuff