Use data pipe to pass DecoderBuffer contents

media/mojo/interfaces/decryptor.mojom

 // Copyright 2014 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 module media.interfaces;
 
 import "media/mojo/interfaces/demuxer_stream.mojom";
 import "media/mojo/interfaces/media_types.mojom";
 
 // Interface for decrypting (and decoding) encrypted streams.
 // See media/base/decryptor.h for details.
 interface Decryptor {
   // Status of a decrypt or decrypt-and-decode operation. The returned
   // buffer/frame of such an operation is NOT null iff the status is SUCCESS.
   enum Status {
     SUCCESS,  // Successfully completed. Decrypted buffer ready.
     NO_KEY,  // No key is available to decrypt.
     NEED_MORE_DATA,  // Decoder needs more data to produce an output.
     ERROR  // Key is available but an error occurred during decryption.
   };
 
+  // Pass the two data pipes used to transfer DecoderBuffer contents to and
+  // from the Decryptor.

[xhwang, 2015/12/19 18:16:30]

Must be called before all other methods?

[jrummell, 2015/12/21 23:20:54]

Done.

+  Initialize(handle<data_pipe_consumer> receive_pipe,
+             handle<data_pipe_producer> transmit_pipe);

[xhwang, 2015/12/19 18:16:30]

Since this is an interface, provide more details about how to setup and use
these two pipes... For example, what kind of data should be written to the
|transmit_pipe|, and what kind of data should be read from the |receive_pipe|...

[jrummell, 2015/12/21 23:20:54]

Done.

+
   // Decrypts the |encrypted| buffer and returns the decrypt |status| and
   // decrypted |buffer|.
   // At most one decrypt call is allowed at any time for a |stream_type|.
   Decrypt(DemuxerStream.Type stream_type, DecoderBuffer encrypted)
       => (Status status, DecoderBuffer? buffer);
 
   // Cancels any pending decrypt for |stream_type| with SUCCESS.
   CancelDecrypt(DemuxerStream.Type stream_type);
 
   // Initializes a decoder with the given |config|. Returns whether the
@@ skipping 22 matching lines @@
 
   // Releases decoder resources, deinitializes the decoder, aborts any pending
   // initialization (with false) or decrypt-and-decode (with ERROR) for
   // |stream_type| immediately.
   // This method can be called any time after Initialize{Audio|Video}Decoder()
   // has been called (with the correct stream type).
   // After this operation, the decoder is set to an uninitialized state.
   // The decoder can be reinitialized after it is deinitialized.
   DeinitializeDecoder(DemuxerStream.Type stream_type);
 };