media/base/cdm_context.h

   1 // Copyright 2014 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_CDM_CONTEXT_H_
   6 #define MEDIA_BASE_CDM_CONTEXT_H_
   7
   8 #include "base/callback.h"
   9 #include "base/macros.h"
  10 #include "media/base/media_export.h"
  11
  12 namespace media {
  13
  14 class Decryptor;
  15
  16 // An interface representing the context that a media pipeline needs from a
  17 // content decryption module (CDM) to decrypt (and decode) encrypted buffers.
  18 class MEDIA_EXPORT CdmContext {
  19  public:
  20   // Indicates an invalid CDM ID. See GetCdmId() for details.
  21   static const int kInvalidCdmId = 0;
  22
  23   virtual ~CdmContext();
  24
  25   // Gets the Decryptor object associated with the CDM. Returns NULL if the CDM
  26   // does not support a Decryptor. The returned object is only guaranteed to be
  27   // valid during the CDM's lifetime.
  28   virtual Decryptor* GetDecryptor() = 0;
  29
  30   // Returns an ID associated with the CDM, which can be used to locate the real
  31   // CDM instance. This is useful when the CDM is hosted remotely, e.g. in a
  32   // different process.
  33   // Returns kInvalidCdmId if the CDM cannot be used remotely. In this case,
  34   // GetDecryptor() should return a non-null Decryptor.
  35   virtual int GetCdmId() const = 0;
  36
  37  protected:
  38   CdmContext();
  39
  40  private:
  41   DISALLOW_COPY_AND_ASSIGN(CdmContext);
  42 };
  43
  44 // Callback to notify that the CdmContext has been completely attached to
  45 // the media pipeline. Parameter indicates whether the operation succeeded.
  46 typedef base::Callback<void(bool)> CdmAttachedCB;
  47
  48 // A dummy implementation of CdmAttachedCB.
  49 MEDIA_EXPORT void IgnoreCdmAttached(bool success);
  50
  51 }  // namespace media
  52
  53 #endif  // MEDIA_BASE_CDM_CONTEXT_H_