Struct UsbFunctionSynchronousProxy 

pub struct UsbFunctionSynchronousProxy { /* private fields */ }

Implementations

impl UsbFunctionSynchronousProxy

pub fn new(channel: Channel) -> Self

pub fn into_channel(self) -> Channel

pub fn wait_for_event( &self, deadline: MonotonicInstant, ) -> Result<UsbFunctionEvent, Error>

Waits until an event arrives and returns it. It is safe for other threads to make concurrent requests while waiting for an event.

pub fn connect_to_endpoint( &self, ep_addr: u8, ep: ServerEnd<EndpointMarker>, ___deadline: MonotonicInstant, ) -> Result<UsbFunctionConnectToEndpointResult, Error>

Connects to endpoint. Returns

• ZX_ERR_NOT_FOUND: if endpoint address does not exist.
• ZX_ERR_ALREADY_BOUND: if the endpoint is already bound.

pub fn configure( &self, configuration: &[u8], iface: ClientEnd<UsbFunctionInterfaceMarker>, ___deadline: MonotonicInstant, ) -> Result<UsbFunctionConfigureResult, Error>

Configures the function with the given descriptors.

configuration is a vector of USB descriptors to configure the function with. The descriptors are concatenated together following the USB specification to form the configuration. iface provides the control-plane callbacks for the function.

The function is unregistered from the USB function manager when iface is closed.

Any resource address and numbers referenced in configuration must have been allocated by a previous call to AllocResources.

Returns ZX_ERR_INVALID_ARGS if the configuration is invalid.

pub fn deconfigure( &self, ___deadline: MonotonicInstant, ) -> Result<UsbFunctionDeconfigureResult, Error>

Deconfigures the function.

This is the opposite of Configure. The server drops its connection to the function upon receiving the call, if it’s bound.

Returns after the function channel has been unbound from the server.

Trivially succeeds if no function interface is bound.

Returns ZX_ERR_UNAVAILABLE if a deconfiguration is already in progress.

pub fn alloc_resources( &self, interface_count: u8, endpoints: Vec<EndpointResource>, strings: &[String], ___deadline: MonotonicInstant, ) -> Result<UsbFunctionAllocResourcesResult, Error>

Allocates resources for the function.

This function is used to allocate resources for the function.

interface_count informs how many interfaces to create. interface_nums returns the allocate interface numbers referencing the requested interfaces.

endpoints is a vector of endpoints to allocate. The direction and endpoint server end are provided. endpoint_addrs returns a vector of the same size containing the allocated endpoint addresses. On success the endpoint server ends are connected to a server. Closed otherwise.

strings is a vector of strings to allocate. string_indices returns a vector of the same size containing the allocated string indices.

Returns the interface ids, endpoint ids, and string ids that were allocated. On error, no resources are allocated. Returns:

• ZX_ERR_NO_RESOURCES if any resource namespace numbers are exhausted.

The allocated resource numbers and addresses remain allocated for the lifetime of the connection to UsbFunction.

pub fn endpoint_set_stall( &self, endpoint_address: u8, ___deadline: MonotonicInstant, ) -> Result<UsbFunctionEndpointSetStallResult, Error>

Sets stall state in an endpoint.

Returns

• ZX_ERR_IO_NOT_PRESENT: If device is not running, disconnected, or inactive.
• ZX_ERR_NOT_FOUND: If endpoint address does not exist.

pub fn endpoint_clear_stall( &self, endpoint_address: u8, ___deadline: MonotonicInstant, ) -> Result<UsbFunctionEndpointClearStallResult, Error>

Clears stall state in an endpoint.

Returns

• ZX_ERR_IO_NOT_PRESENT: If device is not running, disconnected, or inactive.
• ZX_ERR_NOT_FOUND: If endpoint address does not exist.

pub fn configure_endpoint( &self, endpoint_address: u8, endpoint_configuration: &EndpointConfiguration, ___deadline: MonotonicInstant, ) -> Result<UsbFunctionConfigureEndpointResult, Error>

Configure and enable an endpoint with the given configuration.

See usb20 9.6.6.

Returns

• ZX_ERR_IO_NOT_PRESENT: If device is not running, disconnected, or inactive.
• ZX_ERR_NOT_FOUND: If endpoint address does not exist.
• ZX_ERR_INVALID_ARGS: If the configuration is invalid.

pub fn disable_endpoint( &self, endpoint_address: u8, ___deadline: MonotonicInstant, ) -> Result<UsbFunctionDisableEndpointResult, Error>

Disable an endpoint.

Returns

• ZX_ERR_IO_NOT_PRESENT: If device is not running, disconnected, or inactive.
• ZX_ERR_NOT_FOUND: If endpoint address does not exist.

Trait Implementations

impl Debug for UsbFunctionSynchronousProxy

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

Formats the value using the given formatter.

impl From<Channel> for UsbFunctionSynchronousProxy

Available on Fuchsia only.

fn from(value: Channel) -> Self

Converts to this type from the input type.

impl From<UsbFunctionSynchronousProxy> for NullableHandle

Available on Fuchsia only.

fn from(value: UsbFunctionSynchronousProxy) -> Self

Converts to this type from the input type.

impl FromClient for UsbFunctionSynchronousProxy

Available on Fuchsia only.

type Protocol = UsbFunctionMarker

The protocol.

fn from_client(value: ClientEnd<UsbFunctionMarker>) -> Self

Converts from a client.

impl SynchronousProxy for UsbFunctionSynchronousProxy

Available on Fuchsia only.

type Proxy = UsbFunctionProxy

The async proxy for the same protocol.

type Protocol = UsbFunctionMarker

The protocol which this Proxy controls.

fn from_channel(inner: Channel) -> Self

Create a proxy over the given channel.

fn into_channel(self) -> Channel

Convert the proxy back into a channel.

fn as_channel(&self) -> &Channel

Get a reference to the proxy’s underlying channel.

fn is_closed(&self) -> Result<bool, Status>

Returns true if the proxy has received the PEER_CLOSED signal.