Struct CompositeSynchronousProxy

Source

pub struct CompositeSynchronousProxy { /* private fields */ }

Implementations§

Source §

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

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

Source

pub fn get_health_state( &self, ___deadline: MonotonicInstant, ) -> Result<HealthState, Error>

Retrieves top level health state. A driver not responding promptly can be used as an indication of an unhealthy driver.

Source

pub fn signal_processing_connect( &self, protocol: ServerEnd<SignalProcessingMarker>, ) -> Result<(), Error>

Connect to a SignalProcessing protocol. Multiple connections may be supported, if a new connection request is not supported, i.e. the maximum number of connections have already been created, for instance one, then the protocol channel (not the channel upon which SignalProcessingConnect is being called) will be closed with a ZX_ERR_ALREADY_BOUND epitaph. If signal processing is not supported at all, then the protocol channel (again, not the channel upon which SignalProcessingConnect is being called) will be closed with a ZX_ERR_NOT_SUPPORTED epitaph. This method is named SignalProcessingConnect instead of Connect because this protocol is intended to be composed, and hence the more verbose name allows differentiation and improved clarity.

Source

pub fn reset( &self, ___deadline: MonotonicInstant, ) -> Result<CompositeResetResult, Error>

Resets the hardware including all DAI interconnects and signal processing. As a result, all channels obtained by CreateRingBuffer will be closed.

Reset returns when the hardware is fully reset. At this point, a client would need to reconfigure any DAI interconnects, select a signal processing topology and reconfigure any processing elements, and reconstruct any ring buffers.

If the driver can’t successfully reset the hardware, it will return an error and then close the protocol channel, in this case the client may obtain a new protocol channel and retry.

Source

pub fn get_properties( &self, ___deadline: MonotonicInstant, ) -> Result<CompositeProperties, Error>

Retrieves top level static properties.

Source

pub fn get_ring_buffer_formats( &self, processing_element_id: u64, ___deadline: MonotonicInstant, ) -> Result<CompositeGetRingBufferFormatsResult, Error>

Retrieves the ring buffer formats supported by a RING_BUFFER processing element in the topology supported by this driver as returned by GetElements from fuchsia.hardware.audio.signalprocessing. Returns SHOULD_WAIT if the ring buffer formats are not available at the time, the client may retry at a later time. Returns INVALID_ARGS if the processing_element_id does not match an id returned by GetElements. Returns WRONG_TYPE if the ElementType of the element represented by the id is not RING_BUFFER. Retrieving multiple SupportedFormats2 allows for cases where exclusive combinations of the parameters in SupportedFormats2 may be supported. The vector returned to the caller must contain at least one entry.

Source

pub fn create_ring_buffer( &self, processing_element_id: u64, format: &Format2, ring_buffer: ServerEnd<RingBufferMarker>, ___deadline: MonotonicInstant, ) -> Result<CompositeCreateRingBufferResult, Error>

CreateRingBuffer is sent by clients to select a ring buffer format for the RING_BUFFER processing element specified by processing_element_id. The format is based on information that the driver provides in GetRingBufferFormats, what is supported by the client, and any other requirement. The returned ring_buffer channel is used to access and control the audio buffer provided by the driver. Returns INVALID_ARGS if the processing_element_id does not match an id returned by GetElements. Returns WRONG_TYPE if the ElementType of the element represented by the id is not RING_BUFFER. Returns NOT_SUPPORTED if the driver does not support ring buffers, or if the specified format is not supported.

Source

pub fn get_dai_formats( &self, processing_element_id: u64, ___deadline: MonotonicInstant, ) -> Result<CompositeGetDaiFormatsResult, Error>

Retrieves the DAI formats supported by a DAI_INTERCONNECT processing element in the topology supported by this driver as returned by GetElements from fuchsia.hardware.audio.signalprocessing. Returns SHOULD_WAIT if the DAI formats are not available at the time, the client may retry at a later time. Returns INVALID_ARGS if the processing_element_id does not match an id returned by GetElements. Returns WRONG_TYPE if the ElementType of the element represented by the id is not DAI_INTERCONNECT. Retrieving multiple DaiSupportedFormats allows for cases where exclusive combinations of the parameters in DaiSupportedFormats may be supported. The vector returned to the caller must contain at least one entry.

Source

pub fn set_dai_format( &self, processing_element_id: u64, format: &DaiFormat, ___deadline: MonotonicInstant, ) -> Result<CompositeSetDaiFormatResult, Error>

SetDaiFormat is sent by clients to select a DAI format for the DAI_INTERCONNECT processing element specified by processing_element_id. The format is based on information that the driver provides in GetDaiFormats, what is supported by the client, and any other requirement. Returns INVALID_ARGS if the processing_element_id does not match an id returned by GetElements. Returns WRONG_TYPE if the ElementType of the element represented by the id is not DAI_INTERCONNECT.

Source

pub fn get_packet_stream_formats( &self, processing_element_id: u64, ___deadline: MonotonicInstant, ) -> Result<CompositeGetPacketStreamFormatsResult, Error>

Retrieves the packet-stream formats supported by a PACKET_STREAM processing element in the topologies supported by this driver, as returned by GetElements and GetTopologies from fuchsia.hardware.audio.signalprocessing.

Returns SHOULD_WAIT if the packet-stream formats are not available at this time. The client may retry this request at a later time. Returns INVALID_ARGS if the processing_element_id does not match an id returned by GetElements. Returns WRONG_TYPE if the ElementType of the element represented by the id is not PACKET_STREAM. Returns NOT_SUPPORTED if the driver does not support packet streams. Returning a vector with multiple SupportedFormats2 enables cases where exclusive combinations of the parameters in SupportedFormats2 may be supported. The vector returned to the caller must contain at least one entry.

Source

pub fn create_packet_stream( &self, processing_element_id: u64, format: &Format2, packet_stream_control: ServerEnd<PacketStreamControlMarker>, ___deadline: MonotonicInstant, ) -> Result<CompositeCreatePacketStreamResult, Error>

CreatePacketStream is sent by clients to select a packet-stream format for the PACKET_STREAM processing element specified by processing_element_id. The format is based on information that the driver provides in GetPacketStreamFormats, what is supported by the client, and any other requirement. The returned packet_stream channel is used to access and control the packet stream protocol served by the driver.

Returns INVALID_ARGS if the processing_element_id does not match an id returned by GetElements. Returns WRONG_TYPE if the ElementType of the element represented by the id is not PACKET_STREAM. Returns SHOULD_WAIT if the server cannot create a packet stream for this element/format at this time, but it should be able to at some future time. This request can be retried. Returns NOT_SUPPORTED if the driver does not support packet streams, or if the specified format is not supported.