Sound:
[blender.git] / intern / audaspace / intern / AUD_C-API.h
index 6ec5ec87ad5fb2bd88a65a21836b612921f5076f..b02b465bff239366778363658970383bffbf20d2 100644 (file)
@@ -303,9 +303,20 @@ extern AUD_Device* AUD_openReadDevice(AUD_Specs specs);
  * Plays back a sound file through a read device.
  * \param device The read device.
  * \param sound The handle of the sound file.
- * \return Whether the sound could be played back.
+ * \return A handle to the played back sound.
+ */
+extern AUD_Handle* AUD_playDevice(AUD_Device* device, AUD_Sound* sound);
+
+/**
+ * Sets the volume of a played back sound of a read device.
+ * \param device The read device.
+ * \param handle The handle to the sound.
+ * \param volume The new volume, must be between 0.0 and 1.0.
+ * \return Whether the action succeeded.
  */
-extern int AUD_playDevice(AUD_Device* device, AUD_Sound* sound);
+extern int AUD_setDeviceSoundVolume(AUD_Device* device,
+                                                                       AUD_Handle* handle,
+                                                                       float volume);
 
 /**
  * Reads the next samples into the supplied buffer.