Struct PeekedWork 

pub struct PeekedWork<'a> { /* private fields */ }

A descriptor that has been peeked from a VirtioQueue without advancing the available index.

The descriptor remains in the available ring until consume is called, which advances the index and returns a normal VirtioQueueCallbackWork for completion.

Dropping a PeekedWork without consuming is a no-op — the descriptor stays available for the next peek/next call.

Implementations

impl<'a> PeekedWork<'a>

pub fn payload(&self) -> &[VirtioQueuePayload]

Returns the payload descriptors.

pub fn readable_length(&self) -> u64

Total length of all readable (guest-written) payload buffers.

pub fn read( &self, mem: &GuestMemory, target: &mut [u8], ) -> Result<usize, GuestMemoryError>

Read all readable payload into target.

pub fn read_at_offset( &self, offset: u64, mem: &GuestMemory, target: &mut [u8], ) -> Result<usize, GuestMemoryError>

Read readable payload into target, skipping the first offset bytes of readable data.

pub fn consume(self) -> VirtioQueueCallbackWork

Consume this peeked work, advancing the queue’s available index.

Returns a VirtioQueueCallbackWork that must be explicitly completed via VirtioQueue::complete.