AudioRecord.cpp revision a075db4ff9b086ac2885df77bb6da0869293df92 
1/*
2**
3** Copyright 2008, The Android Open Source Project
4**
5** Licensed under the Apache License, Version 2.0 (the "License");
6** you may not use this file except in compliance with the License.
7** You may obtain a copy of the License at
8**
9**     http://www.apache.org/licenses/LICENSE-2.0
10**
11** Unless required by applicable law or agreed to in writing, software
12** distributed under the License is distributed on an "AS IS" BASIS,
13** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14** See the License for the specific language governing permissions and
15** limitations under the License.
16*/
17
18//#define LOG_NDEBUG 0
19#define LOG_TAG "AudioRecord"
20
21#include <stdint.h>
22#include <sys/types.h>
23
24#include <sched.h>
25#include <sys/resource.h>
26
27#include <private/media/AudioTrackShared.h>
28
29#include <media/AudioSystem.h>
30#include <media/AudioRecord.h>
31#include <media/mediarecorder.h>
32
33#include <binder/IServiceManager.h>
34#include <utils/Log.h>
35#include <binder/Parcel.h>
36#include <binder/IPCThreadState.h>
37#include <utils/Timers.h>
38#include <utils/Atomic.h>
39
40#include <system/audio.h>
41#include <cutils/bitops.h>
42#include <cutils/compiler.h>
43
44namespace android {
45// ---------------------------------------------------------------------------
46
47// static
48status_t AudioRecord::getMinFrameCount(
49        int* frameCount,
50        uint32_t sampleRate,
51        audio_format_t format,
52        int channelCount)
53{
54    size_t size = 0;
55    if (AudioSystem::getInputBufferSize(sampleRate, format, channelCount, &size)
56            != NO_ERROR) {
57        ALOGE("AudioSystem could not query the input buffer size.");
58        return NO_INIT;
59    }
60
61    if (size == 0) {
62        ALOGE("Unsupported configuration: sampleRate %d, format %d, channelCount %d",
63            sampleRate, format, channelCount);
64        return BAD_VALUE;
65    }
66
67    // We double the size of input buffer for ping pong use of record buffer.
68    size <<= 1;
69
70    if (audio_is_linear_pcm(format)) {
71        size /= channelCount * audio_bytes_per_sample(format);
72    }
73
74    *frameCount = size;
75    return NO_ERROR;
76}
77
78// ---------------------------------------------------------------------------
79
80AudioRecord::AudioRecord()
81    : mStatus(NO_INIT), mSessionId(0),
82      mPreviousPriority(ANDROID_PRIORITY_NORMAL), mPreviousSchedulingGroup(ANDROID_TGROUP_DEFAULT)
83{
84}
85
86AudioRecord::AudioRecord(
87        audio_source_t inputSource,
88        uint32_t sampleRate,
89        audio_format_t format,
90        uint32_t channelMask,
91        int frameCount,
92        record_flags flags,
93        callback_t cbf,
94        void* user,
95        int notificationFrames,
96        int sessionId)
97    : mStatus(NO_INIT), mSessionId(0),
98      mPreviousPriority(ANDROID_PRIORITY_NORMAL), mPreviousSchedulingGroup(ANDROID_TGROUP_DEFAULT)
99{
100    mStatus = set(inputSource, sampleRate, format, channelMask,
101            frameCount, flags, cbf, user, notificationFrames, sessionId);
102}
103
104AudioRecord::~AudioRecord()
105{
106    if (mStatus == NO_ERROR) {
107        // Make sure that callback function exits in the case where
108        // it is looping on buffer empty condition in obtainBuffer().
109        // Otherwise the callback thread will never exit.
110        stop();
111        if (mClientRecordThread != 0) {
112            mClientRecordThread->requestExitAndWait();
113            mClientRecordThread.clear();
114        }
115        mAudioRecord.clear();
116        IPCThreadState::self()->flushCommands();
117        AudioSystem::releaseAudioSessionId(mSessionId);
118    }
119}
120
121status_t AudioRecord::set(
122        audio_source_t inputSource,
123        uint32_t sampleRate,
124        audio_format_t format,
125        uint32_t channelMask,
126        int frameCount,
127        record_flags flags,
128        callback_t cbf,
129        void* user,
130        int notificationFrames,
131        bool threadCanCallJava,
132        int sessionId)
133{
134
135    ALOGV("set(): sampleRate %d, channelMask %d, frameCount %d",sampleRate, channelMask, frameCount);
136
137    AutoMutex lock(mLock);
138
139    if (mAudioRecord != 0) {
140        return INVALID_OPERATION;
141    }
142
143    if (inputSource == AUDIO_SOURCE_DEFAULT) {
144        inputSource = AUDIO_SOURCE_MIC;
145    }
146
147    if (sampleRate == 0) {
148        sampleRate = DEFAULT_SAMPLE_RATE;
149    }
150    // these below should probably come from the audioFlinger too...
151    if (format == AUDIO_FORMAT_DEFAULT) {
152        format = AUDIO_FORMAT_PCM_16_BIT;
153    }
154    // validate parameters
155    if (!audio_is_valid_format(format)) {
156        ALOGE("Invalid format");
157        return BAD_VALUE;
158    }
159
160    if (!audio_is_input_channel(channelMask)) {
161        return BAD_VALUE;
162    }
163
164    int channelCount = popcount(channelMask);
165
166    if (sessionId == 0 ) {
167        mSessionId = AudioSystem::newAudioSessionId();
168    } else {
169        mSessionId = sessionId;
170    }
171    ALOGV("set(): mSessionId %d", mSessionId);
172
173    audio_io_handle_t input = AudioSystem::getInput(inputSource,
174                                                    sampleRate,
175                                                    format,
176                                                    channelMask,
177                                                    (audio_in_acoustics_t)flags,
178                                                    mSessionId);
179    if (input == 0) {
180        ALOGE("Could not get audio input for record source %d", inputSource);
181        return BAD_VALUE;
182    }
183
184    // validate framecount
185    int minFrameCount = 0;
186    status_t status = getMinFrameCount(&minFrameCount, sampleRate, format, channelCount);
187    if (status != NO_ERROR) {
188        return status;
189    }
190    ALOGV("AudioRecord::set() minFrameCount = %d", minFrameCount);
191
192    if (frameCount == 0) {
193        frameCount = minFrameCount;
194    } else if (frameCount < minFrameCount) {
195        return BAD_VALUE;
196    }
197
198    if (notificationFrames == 0) {
199        notificationFrames = frameCount/2;
200    }
201
202    // create the IAudioRecord
203    status = openRecord_l(sampleRate, format, channelMask,
204                        frameCount, input);
205    if (status != NO_ERROR) {
206        return status;
207    }
208
209    if (cbf != NULL) {
210        mClientRecordThread = new ClientRecordThread(*this, threadCanCallJava);
211    }
212
213    mStatus = NO_ERROR;
214
215    mFormat = format;
216    // Update buffer size in case it has been limited by AudioFlinger during track creation
217    mFrameCount = mCblk->frameCount;
218    mChannelCount = (uint8_t)channelCount;
219    mChannelMask = channelMask;
220    mActive = 0;
221    mCbf = cbf;
222    mNotificationFrames = notificationFrames;
223    mRemainingFrames = notificationFrames;
224    mUserData = user;
225    // TODO: add audio hardware input latency here
226    mLatency = (1000*mFrameCount) / sampleRate;
227    mMarkerPosition = 0;
228    mMarkerReached = false;
229    mNewPosition = 0;
230    mUpdatePeriod = 0;
231    mInputSource = inputSource;
232    mFlags = flags;
233    mInput = input;
234    AudioSystem::acquireAudioSessionId(mSessionId);
235
236    return NO_ERROR;
237}
238
239status_t AudioRecord::initCheck() const
240{
241    return mStatus;
242}
243
244// -------------------------------------------------------------------------
245
246uint32_t AudioRecord::latency() const
247{
248    return mLatency;
249}
250
251audio_format_t AudioRecord::format() const
252{
253    return mFormat;
254}
255
256int AudioRecord::channelCount() const
257{
258    return mChannelCount;
259}
260
261uint32_t AudioRecord::frameCount() const
262{
263    return mFrameCount;
264}
265
266size_t AudioRecord::frameSize() const
267{
268    if (audio_is_linear_pcm(mFormat)) {
269        return channelCount()*audio_bytes_per_sample(mFormat);
270    } else {
271        return sizeof(uint8_t);
272    }
273}
274
275audio_source_t AudioRecord::inputSource() const
276{
277    return mInputSource;
278}
279
280// -------------------------------------------------------------------------
281
282status_t AudioRecord::start()
283{
284    status_t ret = NO_ERROR;
285    sp<ClientRecordThread> t = mClientRecordThread;
286
287    ALOGV("start");
288
289    if (t != 0) {
290        if (t->exitPending()) {
291            if (t->requestExitAndWait() == WOULD_BLOCK) {
292                ALOGE("AudioRecord::start called from thread");
293                return WOULD_BLOCK;
294            }
295        }
296    }
297
298    AutoMutex lock(mLock);
299    // acquire a strong reference on the IAudioRecord and IMemory so that they cannot be destroyed
300    // while we are accessing the cblk
301    sp<IAudioRecord> audioRecord = mAudioRecord;
302    sp<IMemory> iMem = mCblkMemory;
303    audio_track_cblk_t* cblk = mCblk;
304    if (mActive == 0) {
305        mActive = 1;
306
307        pid_t tid;
308        if (t != 0) {
309            mReadyToRun = WOULD_BLOCK;
310            t->run("AudioRecord", ANDROID_PRIORITY_AUDIO);
311            tid = t->getTid();  // pid_t is unknown until run()
312            ALOGV("getTid=%d", tid);
313            if (tid == -1) {
314                tid = 0;
315            }
316            // thread blocks in readyToRun()
317        } else {
318            tid = 0;    // not gettid()
319        }
320
321        cblk->lock.lock();
322        if (!(cblk->flags & CBLK_INVALID_MSK)) {
323            cblk->lock.unlock();
324            ALOGV("mAudioRecord->start(tid=%d)", tid);
325            ret = mAudioRecord->start(tid);
326            cblk->lock.lock();
327            if (ret == DEAD_OBJECT) {
328                android_atomic_or(CBLK_INVALID_ON, &cblk->flags);
329            }
330        }
331        if (cblk->flags & CBLK_INVALID_MSK) {
332            ret = restoreRecord_l(cblk);
333        }
334        cblk->lock.unlock();
335        if (ret == NO_ERROR) {
336            mNewPosition = cblk->user + mUpdatePeriod;
337            cblk->bufferTimeoutMs = MAX_RUN_TIMEOUT_MS;
338            cblk->waitTimeMs = 0;
339            if (t != 0) {
340                // thread unblocks in readyToRun() and returns NO_ERROR
341                mReadyToRun = NO_ERROR;
342                mCondition.signal();
343            } else {
344                mPreviousPriority = getpriority(PRIO_PROCESS, 0);
345                mPreviousSchedulingGroup = androidGetThreadSchedulingGroup(0);
346                androidSetThreadPriority(0, ANDROID_PRIORITY_AUDIO);
347            }
348        } else {
349            mActive = 0;
350            // thread unblocks in readyToRun() and returns NO_INIT
351            mReadyToRun = NO_INIT;
352            mCondition.signal();
353        }
354    }
355
356    return ret;
357}
358
359status_t AudioRecord::stop()
360{
361    sp<ClientRecordThread> t = mClientRecordThread;
362
363    ALOGV("stop");
364
365    AutoMutex lock(mLock);
366    if (mActive == 1) {
367        mActive = 0;
368        mCblk->cv.signal();
369        mAudioRecord->stop();
370        // the record head position will reset to 0, so if a marker is set, we need
371        // to activate it again
372        mMarkerReached = false;
373        if (t != 0) {
374            t->requestExit();
375        } else {
376            setpriority(PRIO_PROCESS, 0, mPreviousPriority);
377            androidSetThreadSchedulingGroup(0, mPreviousSchedulingGroup);
378        }
379    }
380
381    return NO_ERROR;
382}
383
384bool AudioRecord::stopped() const
385{
386    return !mActive;
387}
388
389uint32_t AudioRecord::getSampleRate() const
390{
391    AutoMutex lock(mLock);
392    return mCblk->sampleRate;
393}
394
395status_t AudioRecord::setMarkerPosition(uint32_t marker)
396{
397    if (mCbf == NULL) return INVALID_OPERATION;
398
399    mMarkerPosition = marker;
400    mMarkerReached = false;
401
402    return NO_ERROR;
403}
404
405status_t AudioRecord::getMarkerPosition(uint32_t *marker) const
406{
407    if (marker == NULL) return BAD_VALUE;
408
409    *marker = mMarkerPosition;
410
411    return NO_ERROR;
412}
413
414status_t AudioRecord::setPositionUpdatePeriod(uint32_t updatePeriod)
415{
416    if (mCbf == NULL) return INVALID_OPERATION;
417
418    uint32_t curPosition;
419    getPosition(&curPosition);
420    mNewPosition = curPosition + updatePeriod;
421    mUpdatePeriod = updatePeriod;
422
423    return NO_ERROR;
424}
425
426status_t AudioRecord::getPositionUpdatePeriod(uint32_t *updatePeriod) const
427{
428    if (updatePeriod == NULL) return BAD_VALUE;
429
430    *updatePeriod = mUpdatePeriod;
431
432    return NO_ERROR;
433}
434
435status_t AudioRecord::getPosition(uint32_t *position) const
436{
437    if (position == NULL) return BAD_VALUE;
438
439    AutoMutex lock(mLock);
440    *position = mCblk->user;
441
442    return NO_ERROR;
443}
444
445unsigned int AudioRecord::getInputFramesLost() const
446{
447    if (mActive)
448        return AudioSystem::getInputFramesLost(mInput);
449    else
450        return 0;
451}
452
453// -------------------------------------------------------------------------
454
455// must be called with mLock held
456status_t AudioRecord::openRecord_l(
457        uint32_t sampleRate,
458        audio_format_t format,
459        uint32_t channelMask,
460        int frameCount,
461        audio_io_handle_t input)
462{
463    status_t status;
464    const sp<IAudioFlinger>& audioFlinger = AudioSystem::get_audio_flinger();
465    if (audioFlinger == 0) {
466        return NO_INIT;
467    }
468
469    sp<IAudioRecord> record = audioFlinger->openRecord(getpid(), input,
470                                                       sampleRate, format,
471                                                       channelMask,
472                                                       frameCount,
473                                                       IAudioFlinger::TRACK_DEFAULT,
474                                                       &mSessionId,
475                                                       &status);
476
477    if (record == 0) {
478        ALOGE("AudioFlinger could not create record track, status: %d", status);
479        return status;
480    }
481    sp<IMemory> cblk = record->getCblk();
482    if (cblk == 0) {
483        ALOGE("Could not get control block");
484        return NO_INIT;
485    }
486    mAudioRecord.clear();
487    mAudioRecord = record;
488    mCblkMemory.clear();
489    mCblkMemory = cblk;
490    mCblk = static_cast<audio_track_cblk_t*>(cblk->pointer());
491    mCblk->buffers = (char*)mCblk + sizeof(audio_track_cblk_t);
492    android_atomic_and(~CBLK_DIRECTION_MSK, &mCblk->flags);
493    mCblk->bufferTimeoutMs = MAX_RUN_TIMEOUT_MS;
494    mCblk->waitTimeMs = 0;
495    return NO_ERROR;
496}
497
498status_t AudioRecord::obtainBuffer(Buffer* audioBuffer, int32_t waitCount)
499{
500    AutoMutex lock(mLock);
501    int active;
502    status_t result = NO_ERROR;
503    audio_track_cblk_t* cblk = mCblk;
504    uint32_t framesReq = audioBuffer->frameCount;
505    uint32_t waitTimeMs = (waitCount < 0) ? cblk->bufferTimeoutMs : WAIT_PERIOD_MS;
506
507    audioBuffer->frameCount  = 0;
508    audioBuffer->size        = 0;
509
510    uint32_t framesReady = cblk->framesReady();
511
512    if (framesReady == 0) {
513        cblk->lock.lock();
514        goto start_loop_here;
515        while (framesReady == 0) {
516            active = mActive;
517            if (CC_UNLIKELY(!active)) {
518                cblk->lock.unlock();
519                return NO_MORE_BUFFERS;
520            }
521            if (CC_UNLIKELY(!waitCount)) {
522                cblk->lock.unlock();
523                return WOULD_BLOCK;
524            }
525            if (!(cblk->flags & CBLK_INVALID_MSK)) {
526                mLock.unlock();
527                result = cblk->cv.waitRelative(cblk->lock, milliseconds(waitTimeMs));
528                cblk->lock.unlock();
529                mLock.lock();
530                if (mActive == 0) {
531                    return status_t(STOPPED);
532                }
533                cblk->lock.lock();
534            }
535            if (cblk->flags & CBLK_INVALID_MSK) {
536                goto create_new_record;
537            }
538            if (CC_UNLIKELY(result != NO_ERROR)) {
539                cblk->waitTimeMs += waitTimeMs;
540                if (cblk->waitTimeMs >= cblk->bufferTimeoutMs) {
541                    ALOGW(   "obtainBuffer timed out (is the CPU pegged?) "
542                            "user=%08x, server=%08x", cblk->user, cblk->server);
543                    cblk->lock.unlock();
544                    result = mAudioRecord->start(0);    // callback thread hasn't changed
545                    cblk->lock.lock();
546                    if (result == DEAD_OBJECT) {
547                        android_atomic_or(CBLK_INVALID_ON, &cblk->flags);
548create_new_record:
549                        result = AudioRecord::restoreRecord_l(cblk);
550                    }
551                    if (result != NO_ERROR) {
552                        ALOGW("obtainBuffer create Track error %d", result);
553                        cblk->lock.unlock();
554                        return result;
555                    }
556                    cblk->waitTimeMs = 0;
557                }
558                if (--waitCount == 0) {
559                    cblk->lock.unlock();
560                    return TIMED_OUT;
561                }
562            }
563            // read the server count again
564        start_loop_here:
565            framesReady = cblk->framesReady();
566        }
567        cblk->lock.unlock();
568    }
569
570    cblk->waitTimeMs = 0;
571
572    if (framesReq > framesReady) {
573        framesReq = framesReady;
574    }
575
576    uint32_t u = cblk->user;
577    uint32_t bufferEnd = cblk->userBase + cblk->frameCount;
578
579    if (u + framesReq > bufferEnd) {
580        framesReq = bufferEnd - u;
581    }
582
583    audioBuffer->flags       = 0;
584    audioBuffer->channelCount= mChannelCount;
585    audioBuffer->format      = mFormat;
586    audioBuffer->frameCount  = framesReq;
587    audioBuffer->size        = framesReq*cblk->frameSize;
588    audioBuffer->raw         = (int8_t*)cblk->buffer(u);
589    active = mActive;
590    return active ? status_t(NO_ERROR) : status_t(STOPPED);
591}
592
593void AudioRecord::releaseBuffer(Buffer* audioBuffer)
594{
595    AutoMutex lock(mLock);
596    mCblk->stepUser(audioBuffer->frameCount);
597}
598
599audio_io_handle_t AudioRecord::getInput() const
600{
601    AutoMutex lock(mLock);
602    return mInput;
603}
604
605// must be called with mLock held
606audio_io_handle_t AudioRecord::getInput_l()
607{
608    mInput = AudioSystem::getInput(mInputSource,
609                                mCblk->sampleRate,
610                                mFormat,
611                                mChannelMask,
612                                (audio_in_acoustics_t)mFlags,
613                                mSessionId);
614    return mInput;
615}
616
617int AudioRecord::getSessionId() const
618{
619    return mSessionId;
620}
621
622// -------------------------------------------------------------------------
623
624ssize_t AudioRecord::read(void* buffer, size_t userSize)
625{
626    ssize_t read = 0;
627    Buffer audioBuffer;
628    int8_t *dst = static_cast<int8_t*>(buffer);
629
630    if (ssize_t(userSize) < 0) {
631        // sanity-check. user is most-likely passing an error code.
632        ALOGE("AudioRecord::read(buffer=%p, size=%u (%d)",
633                buffer, userSize, userSize);
634        return BAD_VALUE;
635    }
636
637    mLock.lock();
638    // acquire a strong reference on the IAudioRecord and IMemory so that they cannot be destroyed
639    // while we are accessing the cblk
640    sp<IAudioRecord> audioRecord = mAudioRecord;
641    sp<IMemory> iMem = mCblkMemory;
642    mLock.unlock();
643
644    do {
645
646        audioBuffer.frameCount = userSize/frameSize();
647
648        // By using a wait count corresponding to twice the timeout period in
649        // obtainBuffer() we give a chance to recover once for a read timeout
650        // (if media_server crashed for instance) before returning a length of
651        // 0 bytes read to the client
652        status_t err = obtainBuffer(&audioBuffer, ((2 * MAX_RUN_TIMEOUT_MS) / WAIT_PERIOD_MS));
653        if (err < 0) {
654            // out of buffers, return #bytes written
655            if (err == status_t(NO_MORE_BUFFERS))
656                break;
657            if (err == status_t(TIMED_OUT))
658                err = 0;
659            return ssize_t(err);
660        }
661
662        size_t bytesRead = audioBuffer.size;
663        memcpy(dst, audioBuffer.i8, bytesRead);
664
665        dst += bytesRead;
666        userSize -= bytesRead;
667        read += bytesRead;
668
669        releaseBuffer(&audioBuffer);
670    } while (userSize);
671
672    return read;
673}
674
675// -------------------------------------------------------------------------
676
677bool AudioRecord::processAudioBuffer(const sp<ClientRecordThread>& thread)
678{
679    Buffer audioBuffer;
680    uint32_t frames = mRemainingFrames;
681    size_t readSize;
682
683    mLock.lock();
684    // acquire a strong reference on the IAudioRecord and IMemory so that they cannot be destroyed
685    // while we are accessing the cblk
686    sp<IAudioRecord> audioRecord = mAudioRecord;
687    sp<IMemory> iMem = mCblkMemory;
688    audio_track_cblk_t* cblk = mCblk;
689    mLock.unlock();
690
691    // Manage marker callback
692    if (!mMarkerReached && (mMarkerPosition > 0)) {
693        if (cblk->user >= mMarkerPosition) {
694            mCbf(EVENT_MARKER, mUserData, (void *)&mMarkerPosition);
695            mMarkerReached = true;
696        }
697    }
698
699    // Manage new position callback
700    if (mUpdatePeriod > 0) {
701        while (cblk->user >= mNewPosition) {
702            mCbf(EVENT_NEW_POS, mUserData, (void *)&mNewPosition);
703            mNewPosition += mUpdatePeriod;
704        }
705    }
706
707    do {
708        audioBuffer.frameCount = frames;
709        // Calling obtainBuffer() with a wait count of 1
710        // limits wait time to WAIT_PERIOD_MS. This prevents from being
711        // stuck here not being able to handle timed events (position, markers).
712        status_t err = obtainBuffer(&audioBuffer, 1);
713        if (err < NO_ERROR) {
714            if (err != TIMED_OUT) {
715                ALOGE_IF(err != status_t(NO_MORE_BUFFERS), "Error obtaining an audio buffer, giving up.");
716                return false;
717            }
718            break;
719        }
720        if (err == status_t(STOPPED)) return false;
721
722        size_t reqSize = audioBuffer.size;
723        mCbf(EVENT_MORE_DATA, mUserData, &audioBuffer);
724        readSize = audioBuffer.size;
725
726        // Sanity check on returned size
727        if (ssize_t(readSize) <= 0) {
728            // The callback is done filling buffers
729            // Keep this thread going to handle timed events and
730            // still try to get more data in intervals of WAIT_PERIOD_MS
731            // but don't just loop and block the CPU, so wait
732            usleep(WAIT_PERIOD_MS*1000);
733            break;
734        }
735        if (readSize > reqSize) readSize = reqSize;
736
737        audioBuffer.size = readSize;
738        audioBuffer.frameCount = readSize/frameSize();
739        frames -= audioBuffer.frameCount;
740
741        releaseBuffer(&audioBuffer);
742
743    } while (frames);
744
745
746    // Manage overrun callback
747    if (mActive && (cblk->framesAvailable() == 0)) {
748        ALOGV("Overrun user: %x, server: %x, flags %04x", cblk->user, cblk->server, cblk->flags);
749        if (!(android_atomic_or(CBLK_UNDERRUN_ON, &cblk->flags) & CBLK_UNDERRUN_MSK)) {
750            mCbf(EVENT_OVERRUN, mUserData, 0);
751        }
752    }
753
754    if (frames == 0) {
755        mRemainingFrames = mNotificationFrames;
756    } else {
757        mRemainingFrames = frames;
758    }
759    return true;
760}
761
762// must be called with mLock and cblk.lock held. Callers must also hold strong references on
763// the IAudioRecord and IMemory in case they are recreated here.
764// If the IAudioRecord is successfully restored, the cblk pointer is updated
765status_t AudioRecord::restoreRecord_l(audio_track_cblk_t*& cblk)
766{
767    status_t result;
768
769    if (!(android_atomic_or(CBLK_RESTORING_ON, &cblk->flags) & CBLK_RESTORING_MSK)) {
770        ALOGW("dead IAudioRecord, creating a new one");
771        // signal old cblk condition so that other threads waiting for available buffers stop
772        // waiting now
773        cblk->cv.broadcast();
774        cblk->lock.unlock();
775
776        // if the new IAudioRecord is created, openRecord_l() will modify the
777        // following member variables: mAudioRecord, mCblkMemory and mCblk.
778        // It will also delete the strong references on previous IAudioRecord and IMemory
779        result = openRecord_l(cblk->sampleRate, mFormat, mChannelMask,
780                mFrameCount, getInput_l());
781        if (result == NO_ERROR) {
782            result = mAudioRecord->start(0);    // callback thread hasn't changed
783        }
784        if (result != NO_ERROR) {
785            mActive = false;
786        }
787
788        // signal old cblk condition for other threads waiting for restore completion
789        android_atomic_or(CBLK_RESTORED_ON, &cblk->flags);
790        cblk->cv.broadcast();
791    } else {
792        if (!(cblk->flags & CBLK_RESTORED_MSK)) {
793            ALOGW("dead IAudioRecord, waiting for a new one to be created");
794            mLock.unlock();
795            result = cblk->cv.waitRelative(cblk->lock, milliseconds(RESTORE_TIMEOUT_MS));
796            cblk->lock.unlock();
797            mLock.lock();
798        } else {
799            ALOGW("dead IAudioRecord, already restored");
800            result = NO_ERROR;
801            cblk->lock.unlock();
802        }
803        if (result != NO_ERROR || mActive == 0) {
804            result = status_t(STOPPED);
805        }
806    }
807    ALOGV("restoreRecord_l() status %d mActive %d cblk %p, old cblk %p flags %08x old flags %08x",
808        result, mActive, mCblk, cblk, mCblk->flags, cblk->flags);
809
810    if (result == NO_ERROR) {
811        // from now on we switch to the newly created cblk
812        cblk = mCblk;
813    }
814    cblk->lock.lock();
815
816    ALOGW_IF(result != NO_ERROR, "restoreRecord_l() error %d", result);
817
818    return result;
819}
820
821// =========================================================================
822
823AudioRecord::ClientRecordThread::ClientRecordThread(AudioRecord& receiver, bool bCanCallJava)
824    : Thread(bCanCallJava), mReceiver(receiver)
825{
826}
827
828bool AudioRecord::ClientRecordThread::threadLoop()
829{
830    return mReceiver.processAudioBuffer(this);
831}
832
833status_t AudioRecord::ClientRecordThread::readyToRun()
834{
835    AutoMutex(mReceiver.mLock);
836    while (mReceiver.mReadyToRun == WOULD_BLOCK) {
837        mReceiver.mCondition.wait(mReceiver.mLock);
838    }
839    return mReceiver.mReadyToRun;
840}
841
842// -------------------------------------------------------------------------
843
844}; // namespace android
845