USB Libraries Help > USB Host Libraries > USB Audio v1.0 Host Client Driver Library > Library Interface
MPLAB Harmony USB Stack
Library Interface

This section describes the Application Programming Interface (API) functions of the USB Audio v1.0 Host Client Driver Library. 

Refer to each section for a detailed description.

a) Audio Device Access Functions
 
Name 
Description 
 
Schedules an Audio v1.0 control transfer. 
 
Returns information about the next audio stream in the specified audio stream group. 
 
Schedules an audio stream read request for the specified audio stream. 
 
Schedules an audio stream set sampling rate request for the specified audio stream. 
 
Schedules an audio stream write request for the specified audio stream. 
 
Sets an attach/detach event handler. 
 
Retrieves the handle to the first audio control entity 
 
Retrieves the handle to the next audio control entity. 
 
Returns the device object handle for this Audio v1.0 Device. 
 
Retrieves the entity object for the entity ID. 
 
Registers an audio entity request callback function with the Audio v1.0 Client Driver. 
 
Returns the entity type of the audio control entity. 
 
Returns "true" if mute control exists for the specified channel of the feature unit. 
 
Schedules a get mute control request to the specified channel. 
 
Schedules a set mute control request to the specified channel. 
 
Returns the number of channels. 
 
Returns "true" if volume control exists for the specified channel of the feature unit. 
 
Schedules a get current volume control request to the specified channel. 
 
Schedules a control request to the Audio Device feature unit to get the range supported by the volume control on the specified channel. 
 
Schedules a set current volume control request to the specified channel. 
 
Returns ID of the Feature Unit. 
 
Returns the ID of the unit or terminal to which this feature unit is connected. 
 
Returns the associated terminal ID of the audio control terminal. 
 
Returns the terminal ID of the audio control entity. 
 
Returns the number of logical output channels in the terminal's output audio channel cluster. 
 
Returns the ID of the unit or terminal to which this terminal is connected. 
 
Returns the terminal type of the audio control entity. 
b) Audio Stream Access Functions
 
Name 
Description 
 
Schedules an audio stream disable request for the specified audio stream. 
 
Schedules an audio stream enable request for the specified audio stream. 
 
Registers an event handler with the Audio v1.0 Client Driver stream. 
 
Returns information about first audio stream in the specified audio stream group. 
 
Gets the number of stream groups present in the attached Audio v1.0 Device. 
 
Closes the audio stream. 
 
Registers an event handler with the Audio v1.0 Client Driver stream. 
 
Returns the bit resolution of the specified streaming interface setting. 
 
Returns the number of channels of the specified streaming interface setting. 
 
Returns the direction of the specified streaming interface setting. 
 
Returns the format tag of the specified streaming interface setting. 
 
Gets the first streaming interface object from the attached Audio Device. 
 
Gets the next streaming interface object from the attached Audio Device. 
 
Returns the sampling frequencies supported by the specified streaming interface setting. 
 
Returns the sampling frequency type of the specified streaming interface setting. 
 
Schedules a SET_INTERFACE request to the specified audio stream. 
 
Gets the first streaming interface setting object within an audio streaming interface. 
 
Gets the next streaming interface setting object within an audio streaming interface. 
 
Returns the sub-frame size of the specified streaming interface setting. 
 
Returns the terminal link of the specified streaming interface setting. 
 
Opens the specified audio stream. 
 
Schedules an audio stream read request for the specified audio stream. 
 
Schedules an audio stream get sampling rate request for the specified audio stream. 
 
Schedules an audio stream set sampling rate request for the specified audio stream. 
 
Schedules an audio stream write request for the specified audio stream. 
c) Other Functions
 
Name 
Description 
 
Schedules a control request to an Audio Device feature unit to get the number of sub-ranges supported by the volume control on the specified channel. 
 
Returns a structure that describes the spatial location of the logical channels of in the terminal's output audio channel cluster. 
d) Data Types and Constants
 
Name 
Description 
 
USB Host Audio v1.0 Client Driver attach event handler function pointer type. 
 
USB Host Audio v1.0 Class Driver control transfer complete callback function pointer type. 
 
Identifies the possible events that the Audio v1.0 Class Driver can generate. 
 
Defines the type of the Audio v1.0 Host client object. 
 
USB Host Audio v1.0 Client Driver request handle. 
 
USB Host Audio v1.0 Class Driver audio result enumeration. 
 
USB Host Audio v1.0 Class Driver stream direction. 
 
Identifies the possible events that the Audio v1.0 stream can generate. 
 
Identifies the possible events that the CDC Class Driver can generate. 
 
USB Host Audio v1.0 class stream control event data. 
 
USB Host Audio v1.0 class stream control event data. 
 
Defines the type of the CDC Host Client Driver Handle 
 
USB Host Audio v1.0 Class Driver stream event handler function pointer type. 
 
This is macro USB_HOST_AUDIO_V1_0_STREAM_EVENT_READ_COMPLETE_DATA. 
 
Returns the type of the USB Audio v1.0 Host Client Driver event handler. 
 
USB Host CDC Client Driver Result enumeration. 
 
USB Host Audio v1.0 class stream transfer event data. 
 
Defines the type of the Audio v1.0 Host stream handle. 
 
This is type USB_HOST_AUDIO_V1_0_STREAM_INFO. 
 
USB Host CDC Client Driver Transfer Handle 
 
Defines the type of the Audio v1.0 Host stream object. 
 
USB Host Audio v1.0 stream result enumeration. 
 
USB Host Audio v1.0 Class Driver transfer handle. 
 
USB HOST Audio Client Driver interface. 
 
USB Host Audio v1.0 Client Driver invalid request handle. 
 
Defines the type of the Audio v1.0 Host stream invalid handle. 
 
USB Host Audio v1.0 Class Driver invalid transfer handle definition. 
 
USB Host Audio v1.0 Client Driver attach event handler function pointer type. 
 
Defines the type of the Audio v1.0 Host control entity object. 
 
USB Host Audio v1.0 class driver control transfer complete callback function pointer type. 
 
Identifies the possible events that the Audio v1.0 Class Driver attach event handler can generate. 
 
Defines the type of the Audio v1.0 Host client object. 
 
USB Host Audio v1.0 Client Driver request handle. 
 
USB Host Audio v1.0 Class Driver result enumeration. 
 
USB Host Audio v1.0 Class Driver stream direction. 
 
Identifies the possible events that the Audio v1.0 Stream can generate. 
 
USB Host Audio v1.0 Class Driver stream event handler function pointer type. 
 
USB Host Audio v1.0 class stream control event data. 
 
USB Host Audio v1.0 class stream data transfer event data. 
 
Returns the type of the USB Host Audio v1.0 stream event handler. 
 
USB Host Audio v1.0 class stream control event data. 
 
USB Host Audio v1.0 class stream data transfer event data. 
 
Defines the type of the Audio v1.0 Host stream handle. 
 
USB Host Audio v1.0 Class Driver stream data transfer handle. 
 
Defines the type of the Audio v1.0 Host streaming interface object. 
 
Defines the type of the Audio v1.0 Host streaming interface setting object. 
 
Sets an attach/detach event handler. 
 
Returns the device object handle for this Audio v1.0 Device. 
 
This is macro USB_HOST_AUDIO_V1_0_DIRECTION_IN. 
 
This is macro USB_HOST_AUDIO_V1_0_DIRECTION_OUT. 
 
This is macro USB_HOST_AUDIO_V1_0_EVENT_ATTACH. 
 
This is macro USB_HOST_AUDIO_V1_0_EVENT_DETACH. 
 
Returns the type of the USB Host Audio v1.0 stream event handler. 
 
Closes the audio stream. 
 
Opens the specified audio stream. 
 
USB HOST Audio v1.0 Client Driver interface. 
 
USB Host Audio v1.0 Client Driver invalid request handle. 
 
This structure defines USB Host audio stream information structure. 
 
Defines Audio v1.0 Host stream invalid handle. 
 
USB Host Audio v1.0 Class Driver invalid stream data transfer handle. 
 
USB Host Audio v1.0 class stream control event data.