Home | History | Annotate | Download | only in media
      1 /*
      2  * Copyright 2015 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 #ifndef ANDROID_IDATASOURCE_H
     18 #define ANDROID_IDATASOURCE_H
     19 
     20 #include <binder/IInterface.h>
     21 #include <media/stagefright/foundation/ABase.h>
     22 #include <utils/Errors.h>
     23 #include <utils/String8.h>
     24 
     25 namespace android {
     26 
     27 class IMemory;
     28 class DecryptHandle;
     29 
     30 // A binder interface for implementing a stagefright DataSource remotely.
     31 class IDataSource : public IInterface {
     32 public:
     33     DECLARE_META_INTERFACE(DataSource);
     34 
     35     // Get the memory that readAt writes into.
     36     virtual sp<IMemory> getIMemory() = 0;
     37     // Read up to |size| bytes into the memory returned by getIMemory(). Returns
     38     // the number of bytes read, or -1 on error. |size| must not be larger than
     39     // the buffer.
     40     virtual ssize_t readAt(off64_t offset, size_t size) = 0;
     41     // Get the size, or -1 if the size is unknown.
     42     virtual status_t getSize(off64_t* size) = 0;
     43     // This should be called before deleting |this|. The other methods may
     44     // return errors if they're called after calling close().
     45     virtual void close() = 0;
     46     // Get the flags of the source.
     47     // Refer to DataSource:Flags for the definition of the flags.
     48     virtual uint32_t getFlags() = 0;
     49     // get a description of the source, e.g. the url or filename it is based on
     50     virtual String8 toString() = 0;
     51     // Initialize DRM and return a DecryptHandle.
     52     virtual sp<DecryptHandle> DrmInitialization(const char *mime) = 0;
     53 
     54 private:
     55     DISALLOW_EVIL_CONSTRUCTORS(IDataSource);
     56 };
     57 
     58 // ----------------------------------------------------------------------------
     59 
     60 class BnDataSource : public BnInterface<IDataSource> {
     61 public:
     62     virtual status_t onTransact(uint32_t code,
     63                                 const Parcel& data,
     64                                 Parcel* reply,
     65                                 uint32_t flags = 0);
     66 };
     67 
     68 }; // namespace android
     69 
     70 #endif // ANDROID_IDATASOURCE_H
     71