src/multimedia/audio/qaudioinput.cpp
changeset 22 79de32ba3296
parent 19 fcece45ef507
child 25 e24348a560a6
equal deleted inserted replaced
19:fcece45ef507 22:79de32ba3296
   144     handle the error:
   144     handle the error:
   145 
   145 
   146     \snippet doc/src/snippets/audio/main.cpp 0
   146     \snippet doc/src/snippets/audio/main.cpp 0
   147 
   147 
   148     \sa QAudioOutput, QAudioDeviceInfo
   148     \sa QAudioOutput, QAudioDeviceInfo
       
   149 
       
   150     \section1 Symbian Platform Security Requirements
       
   151 
       
   152     On Symbian, processes which use this class must have the
       
   153     \c UserEnvironment platform security capability.  If the client
       
   154     process lacks this capability, calls to either overload of start()
       
   155     will fail.
       
   156     This failure is indicated by the QAudioInput object setting
       
   157     its error() value to \l{QAudio::OpenError} and then emitting a
       
   158     \l{stateChanged()}{stateChanged}(\l{QAudio::StoppedState}) signal.
       
   159 
       
   160     Platform security capabilities are added via the
       
   161     \l{qmake-variable-reference.html#target-capability}{TARGET.CAPABILITY}
       
   162     qmake variable.
   149 */
   163 */
   150 
   164 
   151 /*!
   165 /*!
   152     Construct a new audio input and attach it to \a parent.
   166     Construct a new audio input and attach it to \a parent.
   153     The default audio input device is used with the output
   167     The default audio input device is used with the output
   195      error() is set to QAudio::NoError and the stateChanged() signal is emitted.
   209      error() is set to QAudio::NoError and the stateChanged() signal is emitted.
   196 
   210 
   197      If a problem occurs during this process the error() is set to QAudio::OpenError,
   211      If a problem occurs during this process the error() is set to QAudio::OpenError,
   198      state() is set to QAudio::StoppedState and stateChanged() signal is emitted.
   212      state() is set to QAudio::StoppedState and stateChanged() signal is emitted.
   199 
   213 
       
   214      \sa {Symbian Platform Security Requirements}
       
   215 
   200      \sa QIODevice
   216      \sa QIODevice
   201 */
   217 */
   202 
   218 
   203 void QAudioInput::start(QIODevice* device)
   219 void QAudioInput::start(QIODevice* device)
   204 {
   220 {
   214     QAudio::IdleState, error() is set to QAudio::NoError
   230     QAudio::IdleState, error() is set to QAudio::NoError
   215     and the stateChanged() signal is emitted.
   231     and the stateChanged() signal is emitted.
   216 
   232 
   217     If a problem occurs during this process the error() is set to QAudio::OpenError,
   233     If a problem occurs during this process the error() is set to QAudio::OpenError,
   218     state() is set to QAudio::StoppedState and stateChanged() signal is emitted.
   234     state() is set to QAudio::StoppedState and stateChanged() signal is emitted.
       
   235 
       
   236     \sa {Symbian Platform Security Requirements}
   219 
   237 
   220     \sa QIODevice
   238     \sa QIODevice
   221 */
   239 */
   222 
   240 
   223 QIODevice* QAudioInput::start()
   241 QIODevice* QAudioInput::start()