Home | History | Annotate | Download | only in base 
      1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
      2 // Use of this source code is governed by a BSD-style license that can be
      3 // found in the LICENSE file.
      4 
      5 #ifndef MEDIA_BASE_DEMUXER_STREAM_H_
      6 #define MEDIA_BASE_DEMUXER_STREAM_H_
      7 
      8 #include "base/callback.h"
      9 #include "base/memory/ref_counted.h"
     10 #include "media/base/media_export.h"
     11 
     12 namespace media {
     13 
     14 class AudioDecoderConfig;
     15 class DecoderBuffer;
     16 class VideoDecoderConfig;
     17 
     18 class MEDIA_EXPORT DemuxerStream {
     19  public:
     20   enum Type {
     21     UNKNOWN,
     22     AUDIO,
     23     VIDEO,
     24     NUM_TYPES,  // Always keep this entry as the last one!
     25   };
     26 
     27   // Status returned in the Read() callback.
     28   //  kOk : Indicates the second parameter is Non-NULL and contains media data
     29   //        or the end of the stream.
     30   //  kAborted : Indicates an aborted Read(). This can happen if the
     31   //             DemuxerStream gets flushed and doesn't have any more data to
     32   //             return. The second parameter MUST be NULL when this status is
     33   //             returned.
     34   //  kConfigChange : Indicates that the AudioDecoderConfig or
     35   //                  VideoDecoderConfig for the stream has changed.
     36   //                  The DemuxerStream expects an audio_decoder_config() or
     37   //                  video_decoder_config() call before Read() will start
     38   //                  returning DecoderBuffers again. The decoder will need this
     39   //                  new configuration to properly decode the buffers read
     40   //                  from this point forward. The second parameter MUST be NULL
     41   //                  when this status is returned.
     42   enum Status {
     43     kOk,
     44     kAborted,
     45     kConfigChanged,
     46   };
     47 
     48   // Request a buffer to returned via the provided callback.
     49   //
     50   // The first parameter indicates the status of the read.
     51   // The second parameter is non-NULL and contains media data
     52   // or the end of the stream if the first parameter is kOk. NULL otherwise.
     53   typedef base::Callback<void(Status,
     54                               const scoped_refptr<DecoderBuffer>&)>ReadCB;
     55   virtual void Read(const ReadCB& read_cb) = 0;
     56 
     57   // Returns the audio decoder configuration. It is an error to call this method
     58   // if type() != AUDIO.
     59   virtual AudioDecoderConfig audio_decoder_config() = 0;
     60 
     61   // Returns the video decoder configuration. It is an error to call this method
     62   // if type() != VIDEO.
     63   virtual VideoDecoderConfig video_decoder_config() = 0;
     64 
     65   // Returns the type of stream.
     66   virtual Type type() = 0;
     67 
     68   virtual void EnableBitstreamConverter() = 0;
     69 
     70  protected:
     71   // Only allow concrete implementations to get deleted.
     72   virtual ~DemuxerStream();
     73 };
     74 
     75 }  // namespace media
     76 
     77 #endif  // MEDIA_BASE_DEMUXER_STREAM_H_
     78