AudioRecord.cpp revision 606ee61616efdba4696ae591ad10a4be33d8c946 
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        uint32_t 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        uint32_t 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, flags, 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("ClientRecordThread", 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        uint32_t flags,
462        audio_io_handle_t input)
463{
464    status_t status;
465    const sp<IAudioFlinger>& audioFlinger = AudioSystem::get_audio_flinger();
466    if (audioFlinger == 0) {
467        return NO_INIT;
468    }
469
470    sp<IAudioRecord> record = audioFlinger->openRecord(getpid(), input,
471                                                       sampleRate, format,
472                                                       channelMask,
473                                                       frameCount,
474                                                       ((uint16_t)flags) << 16,
475                                                       &mSessionId,
476                                                       &status);
477
478    if (record == 0) {
479        ALOGE("AudioFlinger could not create record track, status: %d", status);
480        return status;
481    }
482    sp<IMemory> cblk = record->getCblk();
483    if (cblk == 0) {
484        ALOGE("Could not get control block");
485        return NO_INIT;
486    }
487    mAudioRecord.clear();
488    mAudioRecord = record;
489    mCblkMemory.clear();
490    mCblkMemory = cblk;
491    mCblk = static_cast<audio_track_cblk_t*>(cblk->pointer());
492    mCblk->buffers = (char*)mCblk + sizeof(audio_track_cblk_t);
493    android_atomic_and(~CBLK_DIRECTION_MSK, &mCblk->flags);
494    mCblk->bufferTimeoutMs = MAX_RUN_TIMEOUT_MS;
495    mCblk->waitTimeMs = 0;
496    return NO_ERROR;
497}
498
499status_t AudioRecord::obtainBuffer(Buffer* audioBuffer, int32_t waitCount)
500{
501    AutoMutex lock(mLock);
502    int active;
503    status_t result = NO_ERROR;
504    audio_track_cblk_t* cblk = mCblk;
505    uint32_t framesReq = audioBuffer->frameCount;
506    uint32_t waitTimeMs = (waitCount < 0) ? cblk->bufferTimeoutMs : WAIT_PERIOD_MS;
507
508    audioBuffer->frameCount  = 0;
509    audioBuffer->size        = 0;
510
511    uint32_t framesReady = cblk->framesReady();
512
513    if (framesReady == 0) {
514        cblk->lock.lock();
515        goto start_loop_here;
516        while (framesReady == 0) {
517            active = mActive;
518            if (CC_UNLIKELY(!active)) {
519                cblk->lock.unlock();
520                return NO_MORE_BUFFERS;
521            }
522            if (CC_UNLIKELY(!waitCount)) {
523                cblk->lock.unlock();
524                return WOULD_BLOCK;
525            }
526            if (!(cblk->flags & CBLK_INVALID_MSK)) {
527                mLock.unlock();
528                result = cblk->cv.waitRelative(cblk->lock, milliseconds(waitTimeMs));
529                cblk->lock.unlock();
530                mLock.lock();
531                if (mActive == 0) {
532                    return status_t(STOPPED);
533                }
534                cblk->lock.lock();
535            }
536            if (cblk->flags & CBLK_INVALID_MSK) {
537                goto create_new_record;
538            }
539            if (CC_UNLIKELY(result != NO_ERROR)) {
540                cblk->waitTimeMs += waitTimeMs;
541                if (cblk->waitTimeMs >= cblk->bufferTimeoutMs) {
542                    ALOGW(   "obtainBuffer timed out (is the CPU pegged?) "
543                            "user=%08x, server=%08x", cblk->user, cblk->server);
544                    cblk->lock.unlock();
545                    result = mAudioRecord->start(0);    // callback thread hasn't changed
546                    cblk->lock.lock();
547                    if (result == DEAD_OBJECT) {
548                        android_atomic_or(CBLK_INVALID_ON, &cblk->flags);
549create_new_record:
550                        result = AudioRecord::restoreRecord_l(cblk);
551                    }
552                    if (result != NO_ERROR) {
553                        ALOGW("obtainBuffer create Track error %d", result);
554                        cblk->lock.unlock();
555                        return result;
556                    }
557                    cblk->waitTimeMs = 0;
558                }
559                if (--waitCount == 0) {
560                    cblk->lock.unlock();
561                    return TIMED_OUT;
562                }
563            }
564            // read the server count again
565        start_loop_here:
566            framesReady = cblk->framesReady();
567        }
568        cblk->lock.unlock();
569    }
570
571    cblk->waitTimeMs = 0;
572
573    if (framesReq > framesReady) {
574        framesReq = framesReady;
575    }
576
577    uint32_t u = cblk->user;
578    uint32_t bufferEnd = cblk->userBase + cblk->frameCount;
579
580    if (u + framesReq > bufferEnd) {
581        framesReq = bufferEnd - u;
582    }
583
584    audioBuffer->flags       = 0;
585    audioBuffer->channelCount= mChannelCount;
586    audioBuffer->format      = mFormat;
587    audioBuffer->frameCount  = framesReq;
588    audioBuffer->size        = framesReq*cblk->frameSize;
589    audioBuffer->raw         = (int8_t*)cblk->buffer(u);
590    active = mActive;
591    return active ? status_t(NO_ERROR) : status_t(STOPPED);
592}
593
594void AudioRecord::releaseBuffer(Buffer* audioBuffer)
595{
596    AutoMutex lock(mLock);
597    mCblk->stepUser(audioBuffer->frameCount);
598}
599
600audio_io_handle_t AudioRecord::getInput() const
601{
602    AutoMutex lock(mLock);
603    return mInput;
604}
605
606// must be called with mLock held
607audio_io_handle_t AudioRecord::getInput_l()
608{
609    mInput = AudioSystem::getInput(mInputSource,
610                                mCblk->sampleRate,
611                                mFormat,
612                                mChannelMask,
613                                (audio_in_acoustics_t)mFlags,
614                                mSessionId);
615    return mInput;
616}
617
618int AudioRecord::getSessionId() const
619{
620    return mSessionId;
621}
622
623// -------------------------------------------------------------------------
624
625ssize_t AudioRecord::read(void* buffer, size_t userSize)
626{
627    ssize_t read = 0;
628    Buffer audioBuffer;
629    int8_t *dst = static_cast<int8_t*>(buffer);
630
631    if (ssize_t(userSize) < 0) {
632        // sanity-check. user is most-likely passing an error code.
633        ALOGE("AudioRecord::read(buffer=%p, size=%u (%d)",
634                buffer, userSize, userSize);
635        return BAD_VALUE;
636    }
637
638    mLock.lock();
639    // acquire a strong reference on the IAudioRecord and IMemory so that they cannot be destroyed
640    // while we are accessing the cblk
641    sp <IAudioRecord> audioRecord = mAudioRecord;
642    sp <IMemory> iMem = mCblkMemory;
643    mLock.unlock();
644
645    do {
646
647        audioBuffer.frameCount = userSize/frameSize();
648
649        // By using a wait count corresponding to twice the timeout period in
650        // obtainBuffer() we give a chance to recover once for a read timeout
651        // (if media_server crashed for instance) before returning a length of
652        // 0 bytes read to the client
653        status_t err = obtainBuffer(&audioBuffer, ((2 * MAX_RUN_TIMEOUT_MS) / WAIT_PERIOD_MS));
654        if (err < 0) {
655            // out of buffers, return #bytes written
656            if (err == status_t(NO_MORE_BUFFERS))
657                break;
658            if (err == status_t(TIMED_OUT))
659                err = 0;
660            return ssize_t(err);
661        }
662
663        size_t bytesRead = audioBuffer.size;
664        memcpy(dst, audioBuffer.i8, bytesRead);
665
666        dst += bytesRead;
667        userSize -= bytesRead;
668        read += bytesRead;
669
670        releaseBuffer(&audioBuffer);
671    } while (userSize);
672
673    return read;
674}
675
676// -------------------------------------------------------------------------
677
678bool AudioRecord::processAudioBuffer(const sp<ClientRecordThread>& thread)
679{
680    Buffer audioBuffer;
681    uint32_t frames = mRemainingFrames;
682    size_t readSize;
683
684    mLock.lock();
685    // acquire a strong reference on the IAudioRecord and IMemory so that they cannot be destroyed
686    // while we are accessing the cblk
687    sp <IAudioRecord> audioRecord = mAudioRecord;
688    sp <IMemory> iMem = mCblkMemory;
689    audio_track_cblk_t* cblk = mCblk;
690    mLock.unlock();
691
692    // Manage marker callback
693    if (!mMarkerReached && (mMarkerPosition > 0)) {
694        if (cblk->user >= mMarkerPosition) {
695            mCbf(EVENT_MARKER, mUserData, (void *)&mMarkerPosition);
696            mMarkerReached = true;
697        }
698    }
699
700    // Manage new position callback
701    if (mUpdatePeriod > 0) {
702        while (cblk->user >= mNewPosition) {
703            mCbf(EVENT_NEW_POS, mUserData, (void *)&mNewPosition);
704            mNewPosition += mUpdatePeriod;
705        }
706    }
707
708    do {
709        audioBuffer.frameCount = frames;
710        // Calling obtainBuffer() with a wait count of 1
711        // limits wait time to WAIT_PERIOD_MS. This prevents from being
712        // stuck here not being able to handle timed events (position, markers).
713        status_t err = obtainBuffer(&audioBuffer, 1);
714        if (err < NO_ERROR) {
715            if (err != TIMED_OUT) {
716                ALOGE_IF(err != status_t(NO_MORE_BUFFERS), "Error obtaining an audio buffer, giving up.");
717                return false;
718            }
719            break;
720        }
721        if (err == status_t(STOPPED)) return false;
722
723        size_t reqSize = audioBuffer.size;
724        mCbf(EVENT_MORE_DATA, mUserData, &audioBuffer);
725        readSize = audioBuffer.size;
726
727        // Sanity check on returned size
728        if (ssize_t(readSize) <= 0) {
729            // The callback is done filling buffers
730            // Keep this thread going to handle timed events and
731            // still try to get more data in intervals of WAIT_PERIOD_MS
732            // but don't just loop and block the CPU, so wait
733            usleep(WAIT_PERIOD_MS*1000);
734            break;
735        }
736        if (readSize > reqSize) readSize = reqSize;
737
738        audioBuffer.size = readSize;
739        audioBuffer.frameCount = readSize/frameSize();
740        frames -= audioBuffer.frameCount;
741
742        releaseBuffer(&audioBuffer);
743
744    } while (frames);
745
746
747    // Manage overrun callback
748    if (mActive && (cblk->framesAvailable() == 0)) {
749        ALOGV("Overrun user: %x, server: %x, flags %04x", cblk->user, cblk->server, cblk->flags);
750        if (!(android_atomic_or(CBLK_UNDERRUN_ON, &cblk->flags) & CBLK_UNDERRUN_MSK)) {
751            mCbf(EVENT_OVERRUN, mUserData, 0);
752        }
753    }
754
755    if (frames == 0) {
756        mRemainingFrames = mNotificationFrames;
757    } else {
758        mRemainingFrames = frames;
759    }
760    return true;
761}
762
763// must be called with mLock and cblk.lock held. Callers must also hold strong references on
764// the IAudioRecord and IMemory in case they are recreated here.
765// If the IAudioRecord is successfully restored, the cblk pointer is updated
766status_t AudioRecord::restoreRecord_l(audio_track_cblk_t*& cblk)
767{
768    status_t result;
769
770    if (!(android_atomic_or(CBLK_RESTORING_ON, &cblk->flags) & CBLK_RESTORING_MSK)) {
771        ALOGW("dead IAudioRecord, creating a new one");
772        // signal old cblk condition so that other threads waiting for available buffers stop
773        // waiting now
774        cblk->cv.broadcast();
775        cblk->lock.unlock();
776
777        // if the new IAudioRecord is created, openRecord_l() will modify the
778        // following member variables: mAudioRecord, mCblkMemory and mCblk.
779        // It will also delete the strong references on previous IAudioRecord and IMemory
780        result = openRecord_l(cblk->sampleRate, mFormat, mChannelMask,
781                mFrameCount, mFlags, getInput_l());
782        if (result == NO_ERROR) {
783            result = mAudioRecord->start(0);    // callback thread hasn't changed
784        }
785        if (result != NO_ERROR) {
786            mActive = false;
787        }
788
789        // signal old cblk condition for other threads waiting for restore completion
790        android_atomic_or(CBLK_RESTORED_ON, &cblk->flags);
791        cblk->cv.broadcast();
792    } else {
793        if (!(cblk->flags & CBLK_RESTORED_MSK)) {
794            ALOGW("dead IAudioRecord, waiting for a new one to be created");
795            mLock.unlock();
796            result = cblk->cv.waitRelative(cblk->lock, milliseconds(RESTORE_TIMEOUT_MS));
797            cblk->lock.unlock();
798            mLock.lock();
799        } else {
800            ALOGW("dead IAudioRecord, already restored");
801            result = NO_ERROR;
802            cblk->lock.unlock();
803        }
804        if (result != NO_ERROR || mActive == 0) {
805            result = status_t(STOPPED);
806        }
807    }
808    ALOGV("restoreRecord_l() status %d mActive %d cblk %p, old cblk %p flags %08x old flags %08x",
809         result, mActive, mCblk, cblk, mCblk->flags, cblk->flags);
810
811    if (result == NO_ERROR) {
812        // from now on we switch to the newly created cblk
813        cblk = mCblk;
814    }
815    cblk->lock.lock();
816
817    ALOGW_IF(result != NO_ERROR, "restoreRecord_l() error %d", result);
818
819    return result;
820}
821
822// =========================================================================
823
824AudioRecord::ClientRecordThread::ClientRecordThread(AudioRecord& receiver, bool bCanCallJava)
825    : Thread(bCanCallJava), mReceiver(receiver)
826{
827}
828
829bool AudioRecord::ClientRecordThread::threadLoop()
830{
831    return mReceiver.processAudioBuffer(this);
832}
833
834status_t AudioRecord::ClientRecordThread::readyToRun()
835{
836    AutoMutex(mReceiver.mLock);
837    while (mReceiver.mReadyToRun == WOULD_BLOCK) {
838        mReceiver.mCondition.wait(mReceiver.mLock);
839    }
840    return mReceiver.mReadyToRun;
841}
842
843// -------------------------------------------------------------------------
844
845}; // namespace android
846
847