X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=include%2Fsound.h;h=dab9ea186eb4911361d0da88677718759ab28f82;hb=ddd39d0cc1a025a1e2e3c792cc8286dbdfa29b54;hp=47de9fa3ed3ac70245cbedac9f811d2410009c31;hpb=2850266965ade165f913a66f679a0449faf21180;p=platform%2Fkernel%2Fu-boot.git

diff --git a/include/sound.h b/include/sound.h
index 47de9fa..dab9ea1 100644
--- a/include/sound.h
+++ b/include/sound.h
@@ -69,6 +69,18 @@ struct sound_ops {
 	int (*play)(struct udevice *dev, void *data, uint data_size);
 
 	/**
+	 * stop_play() - Indicate that there is no more data coming
+	 *
+	 * This is called once play() has finished sending all the data to the
+	 * output device. This may be used to tell the hardware to turn off the
+	 * codec, for example.
+	 *
+	 * @dev: Sound device
+	 * @return 0 if OK, -ve on error
+	 */
+	int (*stop_play)(struct udevice *dev);
+
+	/**
 	 * start_beep() - Start beeping (optional)
 	 *
 	 * This tells the sound hardware to start a beep. It will continue until
@@ -104,7 +116,7 @@ int sound_setup(struct udevice *dev);
  * @dev: Sound device
  * @msecs: Duration of beep in milliseconds
  * @frequency_hz: Frequency of the beep in Hertz
- * @return 0 if OK, -ve on error
+ * Return: 0 if OK, -ve on error
  */
 int sound_beep(struct udevice *dev, int msecs, int frequency_hz);
 
@@ -116,7 +128,7 @@ int sound_beep(struct udevice *dev, int msecs, int frequency_hz);
  *
  * @dev: Sound device
  * @frequency_hz: Beep frequency in hertz
- * @return if OK, -ve on error
+ * Return: if OK, -ve on error
  */
 int sound_start_beep(struct udevice *dev, int frequency_hz);
 
@@ -126,7 +138,7 @@ int sound_start_beep(struct udevice *dev, int frequency_hz);
  * This tells the sound hardware to stop a previously started beep.
  *
  * @dev: Sound device
- * @return if OK, -ve on error
+ * Return: if OK, -ve on error
  */
 int sound_stop_beep(struct udevice *dev);