Add writable-size wait timeout log / Terminate write operation with accumulated timeouts

[platform/core/api/audio-io.git] / include / audio_io.h

diff --git a/include/audio_io.h b/include/audio_io.h
index 53e8b0e..421b0d5 100644 (file)
--- a/include/audio_io.h
+++ b/include/audio_io.h
@@ -557,6 +557,48 @@ int audio_in_set_state_changed_cb(audio_in_h input, audio_in_state_changed_cb ca
 int audio_in_unset_state_changed_cb(audio_in_h input);
 
 /**
+ * @brief Gets the volume of the audio input data stream.
+ *
+ * @since_tizen 6.0
+ *
+ * @remarks The default @a volume of the audio input stream is 1.0.
+ *
+ * @param[in] input The handle to the audio input
+ * @param[out] volume The current volume value of the audio input stream
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval #AUDIO_IO_ERROR_NONE Successful
+ * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #AUDIO_IO_ERROR_NOT_SUPPORTED Not supported
+ *
+ * @see audio_in_set_volume()
+ */
+int audio_in_get_volume(audio_in_h input, double *volume);
+
+/**
+ * @brief Sets the volume of the audio input data stream.
+ *
+ * @since_tizen 6.0
+ *
+ * @remarks The default @a volume of the audio input stream is 1.0.
+ *          If the @a volume is less than 1.0, the loudness of recorded data will be decreased.
+ *          If the @a volume is greater than 1.0, the loudness of recorded data will be increased,
+ *          which can be useful when the loudness of original recorded data is too low in certain environments.
+ *          Note that the volume can be clipped if the @a volume is greater than 1.0 and the loudness of original recorded data is high enough.
+ *
+ * @param[in] input The handle to the audio input
+ * @param[in] volume The volume value to be set (0.0 <= volume <= 2.0)
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval #AUDIO_IO_ERROR_NONE Successful
+ * @retval #AUDIO_IO_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #AUDIO_IO_ERROR_NOT_SUPPORTED Not supported
+ *
+ * @see audio_in_get_volume()
+ */
+int audio_in_set_volume(audio_in_h input, double volume);
+
+/**
  * @}
  */