USB Libraries Help > USB Host Libraries > USB Audio v1.0 Host Client Driver Library > Library Interface > a) Audio Device Access Functions > USB_HOST_AUDIO_V1_0_StreamWrite Function
MPLAB Harmony USB Stack
USB_HOST_AUDIO_V1_0_StreamWrite Function

This function schedules an audio stream write request for the specified audio stream. A USB_HOST_AUDIO_V1_0_STREAM_EVENT_WRITE_COMPLETE event is generated when this request is completed. USB_HOST_AUDIO_V1_0_STREAM_EVENT_WRITE_COMPLETE_DATA returns the status and request handle of the request.

C
USB_HOST_AUDIO_V1_RESULT USB_HOST_AUDIO_V1_0_StreamWrite(
    USB_HOST_AUDIO_V1_STREAM_HANDLE streamHandle, 
    USB_HOST_AUDIO_V1_STREAM_TRANSFER_HANDLE * transferHandle, 
    void * source, 
    size_t length
);
Preconditions

The audio stream should have been opened and enabled. The direction of the audio stream should be USB_HOST_AUDIO_V1_0_DIRECTION_OUT.

Parameters
Parameters 
Description 
streamHandle 
Handle to the Audio v1.0 stream 
transferHandle 
Handle to the stream write transfer request 
source 
Pointer to the buffer containing data to be written to the device 
length 
Amount of data to write (in bytes) 
Returns
  • USB_HOST_AUDIO_V1_0_STREAM_RESULT_SUCCESS - The operation was successful
  • USB_HOST_AUDIO_V1_0_STREAM_RESULT_HANDLE_INVALID - The specified audio

stream does not exist

  • USB_HOST_AUDIO_V1_0_STREAM_RESULT_FAILURE - An unknown failure occurred
Remarks

None.