Struct devices::usb::xhci::transfer_ring_controller::TransferRingTrbHandler

pub struct TransferRingTrbHandler {
    mem: GuestMemory,
    port: Arc<UsbPort>,
    interrupter: Arc<Mutex<Interrupter>>,
    slot_id: u8,
    endpoint_id: u8,
    transfer_manager: XhciTransferManager,
    stream_id: Option<u16>,
}

TransferRingTrbHandler handles trbs on transfer ring.

Fields

mem: GuestMemory

port: Arc<UsbPort>

interrupter: Arc<Mutex<Interrupter>>

slot_id: u8

endpoint_id: u8

transfer_manager: XhciTransferManager

stream_id: Option<u16>

Trait Implementations

impl TransferDescriptorHandler for TransferRingTrbHandler

fn handle_transfer_descriptor( &self, descriptor: Vec<AddressedTrb>, completion_event: Event ) -> Result<()>

Process descriptor asynchronously, write complete_event when done.

fn stop(&self) -> bool

Stop is called when trying to stop ring buffer controller. Returns true when stop must be performed asynchronously. This happens because the handler is handling some descriptor asynchronously, the stop callback of ring buffer controller must be called after the async part is handled or canceled. If the TransferDescriptorHandler decide it could stop immediately, it could return false. For example, if a handler submitted a transfer but the transfer has not yet finished. Then guest kernel requests to stop the ring buffer controller. Transfer descriptor handler will return true, thus RingBufferController would transfer to Stopping state. It will be stopped when all pending transfer completed. On the other hand, if hander does not have any pending transfers, it would return false.