* @return @c 0 on success, otherwise a negative error value
* @retval #SOUND_POOL_ERROR_INVALID_PARAMETER
* Invalid parameter (@a pool is NULL or corrupted)
+ * @retval #SOUND_POOL_ERROR_INVALID_OPERATION Invalid operation
*
* @pre Create sound pool handler by calling @ref sound_pool_create()
*
* @return @c 0 on success, otherwise a negative error value
* @retval #SOUND_POOL_ERROR_INVALID_PARAMETER
* Invalid parameter (@a pool is NULL or corrupted, @a tag is NULL)
- * @retval #SOUND_POOL_ERROR_KEY_NOT_AVAILABLE No sources tagged by @a tag exist
- * in pool
*
* @pre Create sound @a pool handler by calling @ref sound_pool_create()
*
* @param [in] callback The callback that will be called after pool state
* will be changed. @a callback will be called
* synchronously
- * @param [in] data The user data to be passed to the @a callback
+ * @param [in] user_data The user data to be passed to the @a callback
* @return @c 0 on success, otherwise a negative error value
* @retval #SOUND_POOL_ERROR_INVALID_PARAMETER Invalid parameter
* (@a pool is NULL or corrupted, or @a callback is NULL)
*
* @pre Create sound pool handler by calling @ref sound_pool_create()
* @pre Load source to @a pool by calling @ref sound_pool_load_source_from_file()
- * @post When playback is finished normally (i.e. @ref sound_pool_stop_stream()
+ * @post When playback is finished normally (i.e. @ref sound_pool_stream_stop()
* will be not used for stream termination) state will be changed to
* SOUND_POOL_STREAM_STATE_FINISHED and memory will be cleared from the
* stream allocated resources automatically
* @return @c 0 on success, otherwise a negative error value
* @retval #SOUND_POOL_ERROR_INVALID_PARAMETER Invalid parameter
* (@a pool is NULL or corrupted, or @a volume is NULL)
- * @retval #SOUND_POOL_ERROR_INVALID_OPERATION Invalid operation
*
* @pre Create sound @a pool handler by calling @ref sound_pool_create()
*
* (@a pool is NULL or corrupted, or @a state is NULL)
* @retval #SOUND_POOL_ERROR_KEY_NOT_AVAILABLE No streams identified by @a id
* exist in pool
- * @retval #SOUND_POOL_ERROR_INVALID_OPERATION Invalid operation
*
* @pre Create sound pool handler by calling @ref sound_pool_create()
* @pre Load source to @a pool by calling @ref sound_pool_load_source_from_file()
* (@a pool is NULL or corrupted, or @a loop is NULL)
* @retval #SOUND_POOL_ERROR_KEY_NOT_AVAILABLE No streams identified by @a id
* exist in pool
- * @retval #SOUND_POOL_ERROR_INVALID_OPERATION Invalid operation
*
* @pre Create sound @a pool handler by calling @ref sound_pool_create()
* @pre Load source to @a pool by calling @ref sound_pool_load_source_from_file()
* (@a pool is NULL or corrupted, or @a volume is NULL)
* @retval #SOUND_POOL_ERROR_KEY_NOT_AVAILABLE No streams identified by @a id
* exist in pool
- * @retval #SOUND_POOL_ERROR_INVALID_OPERATION Invalid operation
*
* @pre Create sound @a pool handler by calling @ref sound_pool_create()
* @pre Load source to @a pool by calling @ref sound_pool_load_source_from_file()
* (@a pool is NULL or corrupted, or @a priority is NULL)
* @retval #SOUND_POOL_ERROR_KEY_NOT_AVAILABLE No streams identified by @a id
* exist in pool
- * @retval #SOUND_POOL_ERROR_INVALID_OPERATION Invalid operation
*
* @pre Create sound @a pool handler by calling @ref sound_pool_create()
* @pre Load source to @a pool by calling @ref sound_pool_load_source_from_file()
* @param [in] callback The callback that will be called after stream state
* will be changed. @a callback will be called
* asynchronously
- * @param [in] data The user data to be passed to the @a callback
+ * @param [in] user_data The user data to be passed to the @a callback
* @return @c 0 on success, otherwise a negative error value
* @retval #SOUND_POOL_ERROR_INVALID_PARAMETER Invalid parameter
* (@a pool is NULL or corrupted, or @a callback is NULL)
sound_pool_error_e ret = _sound_pool_get_source_by_tag(_pool, tag, &_source);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
"getting sound source [%s] from the sound pool", tag);
- SP_INST_CHECK(_source, SOUND_POOL_ERROR_INVALID_OPERATION);
ret = _sound_source_destroy(_source);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
sound_pool_error_e ret = _sound_pool_get_source_by_tag(_pool, tag, &_source);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
"getting sound source [%s] from the sound pool", tag);
- SP_INST_CHECK(_source, SOUND_POOL_ERROR_INVALID_OPERATION);
sound_stream_t *_stream = NULL;
ret = _sound_stream_create(_source, &_stream);
sound_pool_error_e ret = _sound_pool_get_stream_by_id(_pool, id, &_stream);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
"getting sound stream [%u] from the sound pool", id);
- SP_INST_CHECK(_stream, SOUND_POOL_ERROR_INVALID_OPERATION);
ret = _sound_stream_pause(_stream);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
sound_pool_error_e ret = _sound_pool_get_stream_by_id(_pool, id, &_stream);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
"getting sound stream [%u] from the sound pool", id);
- SP_INST_CHECK(_stream, SOUND_POOL_ERROR_INVALID_OPERATION);
ret = _sound_stream_resume(_stream);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
sound_pool_error_e ret = _sound_pool_get_stream_by_id(_pool, id, &_stream);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
"getting sound stream [%u] from the sound pool", id);
- SP_INST_CHECK(_stream, SOUND_POOL_ERROR_INVALID_OPERATION);
ret = _sound_stream_stop(_stream);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
sound_pool_error_e ret = _sound_pool_get_stream_by_id(_pool, id, &_stream);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
"getting sound stream [%u] from the sound pool", id);
- SP_INST_CHECK(_stream, SOUND_POOL_ERROR_INVALID_OPERATION);
ret = _sound_stream_get_state(_stream, state);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
sound_pool_error_e ret = _sound_pool_get_stream_by_id(_pool, id, &_stream);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
"getting sound stream [%u] from the sound pool", id);
- SP_INST_CHECK(_stream, SOUND_POOL_ERROR_INVALID_OPERATION);
ret = _sound_stream_set_loop(_stream, loop);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
sound_pool_error_e ret = _sound_pool_get_stream_by_id(_pool, id, &_stream);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
"getting sound stream [%u] from the sound pool", id);
- SP_INST_CHECK(_stream, SOUND_POOL_ERROR_INVALID_OPERATION);
ret = _sound_stream_get_loop(_stream, loop);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
sound_pool_error_e ret = _sound_pool_get_stream_by_id(_pool, id, &_stream);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
"getting sound stream [%u] from the sound pool", id);
- SP_INST_CHECK(_stream, SOUND_POOL_ERROR_INVALID_OPERATION);
ret = _sound_stream_set_volume(_stream, volume);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
sound_pool_error_e ret = _sound_pool_get_stream_by_id(_pool, id, &_stream);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
"getting sound stream [%u] from the sound pool", id);
- SP_INST_CHECK(_stream, SOUND_POOL_ERROR_INVALID_OPERATION);
ret = _sound_stream_get_volume(_stream, volume);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
sound_pool_error_e ret = _sound_pool_get_stream_by_id(_pool, id, &_stream);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
"getting sound stream [%u] from the sound pool", id);
- SP_INST_CHECK(_stream, SOUND_POOL_ERROR_INVALID_OPERATION);
ret = _sound_stream_set_priority(_stream, priority);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
sound_pool_error_e ret = _sound_pool_get_stream_by_id(_pool, id, &_stream);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
"getting sound stream [%u] from the sound pool", id);
- SP_INST_CHECK(_stream, SOUND_POOL_ERROR_INVALID_OPERATION);
ret = _sound_stream_get_priority(_stream, priority);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
sound_pool_error_e ret = _sound_pool_get_stream_by_id(_pool, id, &_stream);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
"getting sound stream [%u] from the sound pool", id);
- SP_INST_CHECK(_stream, SOUND_POOL_ERROR_INVALID_OPERATION);
ret = _sound_stream_set_callback(_stream, callback, data);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
sound_pool_error_e ret = _sound_pool_get_stream_by_id(_pool, id, &_stream);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "
"getting sound stream [%u] from the sound pool", id);
- SP_INST_CHECK(_stream, SOUND_POOL_ERROR_INVALID_OPERATION);
ret = _sound_stream_unset_callback(_stream);
SP_RETVM_IF(ret != SOUND_POOL_ERROR_NONE, ret, "Error occurred when "