summaryrefslogtreecommitdiffstats
path: root/src/multimedia/controls
diff options
context:
space:
mode:
authorMichael Goddard <michael.goddard@nokia.com>2012-06-12 11:27:24 +1000
committerQt by Nokia <qt-info@nokia.com>2012-06-13 05:53:50 +0200
commitf5e3fdc4a72e1ab26342c4b97408928debc68551 (patch)
tree9347329291a255be9cd993853b780589ff6a6106 /src/multimedia/controls
parent80f37d2d80f16fd653c3e8076acf2865eae028d3 (diff)
Clarify documentation about QAudioDecoder::read and blocking.
It doesn't block - not safe to implement in all cases. Applications can implement blocking semantics based on their usage of event loops or threads. Change-Id: If9a6b1ae7014df63a43989c4940524bc5eaae383 Reviewed-by: Dmytro Poplavskiy <dmytro.poplavskiy@nokia.com>
Diffstat (limited to 'src/multimedia/controls')
-rw-r--r--src/multimedia/controls/qaudiodecodercontrol.cpp7
1 files changed, 3 insertions, 4 deletions
diff --git a/src/multimedia/controls/qaudiodecodercontrol.cpp b/src/multimedia/controls/qaudiodecodercontrol.cpp
index f8e7a0f3f..a44824883 100644
--- a/src/multimedia/controls/qaudiodecodercontrol.cpp
+++ b/src/multimedia/controls/qaudiodecodercontrol.cpp
@@ -177,9 +177,7 @@ QAudioDecoderControl::QAudioDecoderControl(QObject *parent):
\fn QAudioDecoderControl::bufferAvailable() const
Returns true if a buffer is available to be read,
- and false otherwise. If there is no buffer available, calling
- the \l read() function may block until a buffer is available or
- the end of the media is reached
+ and false otherwise.
*/
/*!
@@ -249,7 +247,8 @@ QAudioDecoderControl::QAudioDecoderControl(QObject *parent):
/*!
\fn QAudioDecoderControl::read()
- Read a buffer from the decoder. Returns invalid buffer on failure.
+ Attempts to read a buffer from the decoder, without blocking. Returns invalid buffer if there are
+ no decoded buffers available, or on error.
*/
/*!