diff options
author | christian linke <christian.linke@bmw.de> | 2012-12-17 16:15:11 +0100 |
---|---|---|
committer | christian linke <christian.linke@bmw.de> | 2012-12-17 16:15:11 +0100 |
commit | 54c5e965fe8f9a53a78834028fd65c792493da2b (patch) | |
tree | 560d7b1209e6a8d4798de9568e4b4a947c2ab42a /include/routing/IAmRoutingSend.h | |
parent | 215e8a72dc81e8a86dd5b3a8ca40fd2c7c6a0b9c (diff) | |
download | audiomanager-54c5e965fe8f9a53a78834028fd65c792493da2b.tar.gz |
* added new interfaces & nsm support + nsm tests + fixed some unit tests + fixed rundown
Signed-off-by: christian linke <christian.linke@bmw.de>
Diffstat (limited to 'include/routing/IAmRoutingSend.h')
-rw-r--r-- | include/routing/IAmRoutingSend.h | 92 |
1 files changed, 62 insertions, 30 deletions
diff --git a/include/routing/IAmRoutingSend.h b/include/routing/IAmRoutingSend.h index 4280931..d077c73 100644 --- a/include/routing/IAmRoutingSend.h +++ b/include/routing/IAmRoutingSend.h @@ -12,15 +12,15 @@ * this file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
*
- * \author Christian Mueller, christian.ei.mueller@bmw.de BMW 2011,2012
+ * \author Christian Mueller, christian.linke@bmw.de BMW 2011,2012
*
* \file
* For further information see http://www.genivi.org/.
*
* THIS CODE HAS BEEN GENERATED BY ENTERPRISE ARCHITECT GENIVI MODEL. PLEASE CHANGE ONLY IN ENTERPRISE ARCHITECT AND GENERATE AGAIN
*/
-#if !defined(EA_39D31D03_9B43_4dfe_B134_B2A969767ECB__INCLUDED_)
-#define EA_39D31D03_9B43_4dfe_B134_B2A969767ECB__INCLUDED_
+#if !defined(EA_3921A27D_CF17_4db4_BE29_6A5BD7C5FE53__INCLUDED_)
+#define EA_3921A27D_CF17_4db4_BE29_6A5BD7C5FE53__INCLUDED_
#include <vector>
#include <string>
@@ -30,21 +30,24 @@ namespace am { class IAmRoutingReceive;
} +#include "audiomanagertypes.h" #include "IAmRoutingReceive.h" +#include "projecttypes.h" -#define RoutingSendVersion "1.0" +#define RoutingSendVersion "2.0" namespace am { /** - * This class implements everything from Audiomanager -> RoutingAdapter
- * There are two rules that have to be kept in mind when implementing against this interface:\n
- * \warning
- * 1. CALLS TO THIS INTERFACE ARE NOT THREAD SAFE !!!! \n
- * 2. YOU MAY NOT THE CALLING INTERFACE DURING AN SYNCHRONOUS OR ASYNCHRONOUS CALL THAT EXPECTS A RETURN VALUE.\n
- * \details
- * Violation these rules may lead to unexpected behavior! Nevertheless you can implement thread safe by using the deferred-call pattern described on the wiki which also helps to implement calls that are forbidden.\n
+ * This class implements everything from Audiomanager -> RoutingAdapter + * There are two rules that have to be kept in mind when implementing against this interface:\n + * \warning + * 1. CALLS TO THIS INTERFACE ARE NOT THREAD SAFE !!!! \n + * 2. YOU MAY NOT CALL THE CALLING INTERFACE DURING AN SYNCHRONOUS OR ASYNCHRONOUS CALL THAT EXPECTS A RETURN VALUE.\n + * \details + * Violation these rules may lead to unexpected behavior! Nevertheless you can implement thread safe by using the deferred- + * call pattern described on the wiki which also helps to implement calls that are forbidden.\n * For more information, please check CAmSerializer * @author Christian Mueller - * @created 06-Mar-2012 8:01:09 PM + * @created 16-Dez-2012 15:58:16 */ class IAmRoutingSend { @@ -59,6 +62,12 @@ namespace am { } /** + * This function returns the version of the interface + * + * @param version + */ + virtual void getInterfaceVersion(std::string& version) const =0; + /** * starts up the interface. In the implementations, here is the best place for init routines. * * @param routingreceiveinterface pointer to the receive interface @@ -77,14 +86,14 @@ namespace am { */ virtual void setRoutingRundown(const uint16_t handle) =0; /** - * aborts an asynchronous action.
+ * aborts an asynchronous action. * @return E_OK on success, E_UNKNOWN on error, E_NON_EXISTENT if handle was not found * * @param handle */ virtual am_Error_e asyncAbort(const am_Handle_s handle) =0; /** - * connects a source to a sink
+ * connects a source to a sink * @return E_OK on success, E_UNKNOWN on error, E_WRONG_FORMAT in case am_ConnectionFormat_e does not match * * @param handle @@ -95,7 +104,7 @@ namespace am { */ virtual am_Error_e asyncConnect(const am_Handle_s handle, const am_connectionID_t connectionID, const am_sourceID_t sourceID, const am_sinkID_t sinkID, const am_ConnectionFormat_e connectionFormat) =0; /** - * disconnect a connection with given connectionID
+ * disconnect a connection with given connectionID * @return E_OK on success, E_UNKNOWN on error, E_NON_EXISTENT if connection was not found * * @param handle @@ -103,7 +112,8 @@ namespace am { */ virtual am_Error_e asyncDisconnect(const am_Handle_s handle, const am_connectionID_t connectionID) =0; /** - * this method is used to set the volume of a sink. This function is used to drive ramps, to mute or unmute or directly set the value. The difference is made through the ramptype.
+ * this method is used to set the volume of a sink. This function is used to drive ramps, to mute or unmute or directly + * set the value. The difference is made through the ramptype. * @return E_OK on success, E_UNKNOWN on error, E_OUT_OF_RANGE if new volume is out of range * * @param handle @@ -114,8 +124,9 @@ namespace am { */ virtual am_Error_e asyncSetSinkVolume(const am_Handle_s handle, const am_sinkID_t sinkID, const am_volume_t volume, const am_RampType_e ramp, const am_time_t time) =0; /** - * sets the volume of a source. This method is used to set the volume of a sink. This function is used to drive ramps, to mute or unmute or directly set the value. The difference is made through the ramptype.
- * @return E_OK on success, E_UNKNOWN on error, E_OUT_OF_RANGE if volume is out of range.
+ * sets the volume of a source. This method is used to set the volume of a sink. This function is used to drive ramps, to + * mute or unmute or directly set the value. The difference is made through the ramptype. + * @return E_OK on success, E_UNKNOWN on error, E_OUT_OF_RANGE if volume is out of range. * triggers the acknowledge ackSourceVolumeChange * * @param handle @@ -126,7 +137,7 @@ namespace am { */ virtual am_Error_e asyncSetSourceVolume(const am_Handle_s handle, const am_sourceID_t sourceID, const am_volume_t volume, const am_RampType_e ramp, const am_time_t time) =0; /** - * This function is used to set the source state of a particular source.
+ * This function is used to set the source state of a particular source. * @return E_OK on success, E_UNKNOWN on error * * @param handle @@ -135,7 +146,7 @@ namespace am { */ virtual am_Error_e asyncSetSourceState(const am_Handle_s handle, const am_sourceID_t sourceID, const am_SourceState_e state) =0; /** - * this function sets the sinksoundproperty.
+ * this function sets the sinksoundproperty. * @return E_OK on success, E_UNKNOWN on error, E_OUT_OF_RANGE in case the propery value is out of range * * @param handle @@ -144,7 +155,7 @@ namespace am { */ virtual am_Error_e asyncSetSinkSoundProperties(const am_Handle_s handle, const am_sinkID_t sinkID, const std::vector<am_SoundProperty_s>& listSoundProperties) =0; /** - * this function sets the sinksoundproperty.
+ * this function sets the sinksoundproperty. * @return E_OK on success, E_UNKNOWN on error, E_OUT_OF_RANGE in case the propery value is out of range * * @param handle @@ -153,7 +164,7 @@ namespace am { */ virtual am_Error_e asyncSetSinkSoundProperty(const am_Handle_s handle, const am_sinkID_t sinkID, const am_SoundProperty_s& soundProperty) =0; /** - * this function sets the sourcesoundproperty.
+ * this function sets the sourcesoundproperty. * @return E_OK on success, E_UNKNOWN on error, E_OUT_OF_RANGE in case the propery value is out of range * * @param handle @@ -162,7 +173,7 @@ namespace am { */ virtual am_Error_e asyncSetSourceSoundProperties(const am_Handle_s handle, const am_sourceID_t sourceID, const std::vector<am_SoundProperty_s>& listSoundProperties) =0; /** - * this function sets the sourcesoundproperty.
+ * this function sets the sourcesoundproperty. * @return E_OK on success, E_UNKNOWN on error, E_OUT_OF_RANGE in case the propery value is out of range * * @param handle @@ -171,7 +182,7 @@ namespace am { */ virtual am_Error_e asyncSetSourceSoundProperty(const am_Handle_s handle, const am_sourceID_t sourceID, const am_SoundProperty_s& soundProperty) =0; /** - * this function triggers crossfading.
+ * this function triggers crossfading. * @return E_OK on success, E_UNKNOWN on error * * @param handle @@ -182,7 +193,7 @@ namespace am { */ virtual am_Error_e asyncCrossFade(const am_Handle_s handle, const am_crossfaderID_t crossfaderID, const am_HotSink_e hotSink, const am_RampType_e rampType, const am_time_t time) =0; /** - * this function is used for early and late audio functions to set the domain state
+ * this function is used for early and late audio functions to set the domain state * @return E_OK on success, E_UNKNOWN on error * * @param domainID @@ -190,19 +201,40 @@ namespace am { */ virtual am_Error_e setDomainState(const am_domainID_t domainID, const am_DomainState_e domainState) =0; /** - * this method is used to retrieve the busname during startup of the plugin. Needs to be implemented
+ * this method is used to retrieve the busname during startup of the plugin. Needs to be implemented * @return E_OK on success, E_UNKNOWN on error * * @param BusName */ virtual am_Error_e returnBusName(std::string& BusName) const =0; /** - * This function returns the version of the interface + * This command sets multiple source or and sink volumes within a domain at a time. It can be used to synchronize volume + * setting events. + * @return E_OK on success, E_UNKNOWN on error. * - * @param version + * @param handle the handle + * @param listVolumes a list of volumes that shall be set a the same time */ - virtual void getInterfaceVersion(std::string& version) const =0; + virtual am_Error_e asyncSetVolumes(const am_Handle_s handle, const std::vector<am_Volumes_s>& listVolumes) =0; + /** + * sets the notification configuration of a source. + * @return E_OK on success, E_UNKNOWN on error. + * + * @param handle The handle for this operation. + * @param sinkID the sourceID of the source the notification should be set + * @param notificationConfiguration The notification configuration + */ + virtual am_Error_e asyncSetSinkNotificationConfiguration(const am_Handle_s handle, const am_sinkID_t sinkID, const am_NotificationConfiguration_s& notificationConfiguration) =0; + /** + * sets the notification configuration of a source. + * @return E_OK on success, E_UNKNOWN on error. + * + * @param handle The handle for this operation. + * @param sourceID the sourceID of the source the notification should be set + * @param notificationConfiguration The notification configuration + */ + virtual am_Error_e asyncSetSourceNotificationConfiguration(const am_Handle_s handle, const am_sourceID_t sourceID, const am_NotificationConfiguration_s& notificationConfiguration) =0; }; } -#endif // !defined(EA_39D31D03_9B43_4dfe_B134_B2A969767ECB__INCLUDED_) +#endif // !defined(EA_3921A27D_CF17_4db4_BE29_6A5BD7C5FE53__INCLUDED_) |