From: Sangchul Lee Date: Wed, 7 Jun 2017 02:03:29 +0000 (+0900) Subject: Modifiy description X-Git-Tag: submit/tizen/20170615.073353~1 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=refs%2Fchanges%2F96%2F132596%2F4;p=platform%2Fcore%2Fapi%2Fsound-manager.git Modifiy description It is the revert commit of e0b2bff97347db2af56426c1727020dde0c3e41d(Revise error description). And added more comments for tizen 4.0. [Version] 0.4.9 [Issue Type] Description Change-Id: I0beb6ca1d74fceb6b1bc967867e2f36cc8e522f0 Signed-off-by: Sangchul Lee --- diff --git a/include/sound_manager.h b/include/sound_manager.h index 28ad773..01c4699 100644 --- a/include/sound_manager.h +++ b/include/sound_manager.h @@ -785,6 +785,9 @@ int sound_manager_apply_stream_routing(sound_stream_info_h stream_info); * @brief Acquires the stream focus. * @since_tizen 3.0 * + * @remarks Do not call this function within sound_stream_focus_state_changed_cb() or sound_stream_focus_state_watch_cb(),\n + * otherwise #SOUND_MANAGER_ERROR_INVALID_OPERATION will be returned. Since 4.0, it is allowed and does not return the error. + * * @param[in] stream_info The handle of stream information * @param[in] focus_mask The focus mask that user wants to acquire * @param[in] sound_behavior The requesting sound behavior, values of #sound_behavior_e combined with bitwise 'or' @@ -793,6 +796,7 @@ int sound_manager_apply_stream_routing(sound_stream_info_h stream_info); * otherwise a negative error value * @retval #SOUND_MANAGER_ERROR_NONE Success * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #SOUND_MANAGER_ERROR_INVALID_OPERATION Invalid operation * @retval #SOUND_MANAGER_ERROR_INVALID_STATE Invalid state * @retval #SOUND_MANAGER_ERROR_POLICY Noncompliance with the sound system policy * @retval #SOUND_MANAGER_ERROR_INTERNAL Internal error inside the sound system @@ -811,6 +815,9 @@ int sound_manager_acquire_focus(sound_stream_info_h stream_info, sound_stream_fo * @brief Releases the acquired stream focus. * @since_tizen 3.0 * + * @remarks Do not call this function within sound_stream_focus_state_changed_cb() or sound_stream_focus_state_watch_cb(),\n + * otherwise #SOUND_MANAGER_ERROR_INVALID_OPERATION will be returned. Since 4.0, it is allowed and does not return the error. + * * @param[in] stream_info The handle of stream information * @param[in] focus_mask The focus mask that user wants to release * @param[in] sound_behavior The requesting sound behavior, values of #sound_behavior_e combined with bitwise 'or' @@ -819,6 +826,7 @@ int sound_manager_acquire_focus(sound_stream_info_h stream_info, sound_stream_fo * otherwise a negative error value * @retval #SOUND_MANAGER_ERROR_NONE Success * @retval #SOUND_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #SOUND_MANAGER_ERROR_INVALID_OPERATION Invalid operation * @retval #SOUND_MANAGER_ERROR_INVALID_STATE Invalid state * @retval #SOUND_MANAGER_ERROR_INTERNAL Internal error inside the sound system * @pre Call sound_manager_create_stream_information() and sound_manager_acquire_focus() before calling this function. diff --git a/packaging/capi-media-sound-manager.spec b/packaging/capi-media-sound-manager.spec index 85d471d..3a501a7 100644 --- a/packaging/capi-media-sound-manager.spec +++ b/packaging/capi-media-sound-manager.spec @@ -1,6 +1,6 @@ Name: capi-media-sound-manager Summary: Sound Manager library -Version: 0.4.8 +Version: 0.4.9 Release: 0 Group: Multimedia/API License: Apache-2.0