Reland "Update mojo Decryptor interface to support reusing shared memory"

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.
@@ skipping 33 matching lines @@
   InitializeVideoDecoder(VideoDecoderConfig config) => (bool success);
 
   // Decrypts and decodes the |encrypted| buffer and returns the |status| and
   // the decrypted |audio_buffers| or |video_frame|.
   // At end-of-stream, this method should be called repeatedly with
   // end-of-stream |encrypted| until no buffer/frame can be produced.
   // These methods can only be called after the corresponding decoder has
   // been successfully initialized.
   // At most one decrypt-and-decode call is allowed at any time for a
   // |stream_type|.
+  // For video, ReleaseSharedBuffer() must be called when the VideoFrame
+  // is shared memory based and the memory is no longer needed.
   DecryptAndDecodeAudio(DecoderBuffer encrypted)
       => (Status status, array<AudioBuffer>? audio_buffers);
-  DecryptAndDecodeVideo(
-      DecoderBuffer encrypted) => (Status status, VideoFrame? video_frame);
+  DecryptAndDecodeVideo(DecoderBuffer encrypted)
+      => (Status status, VideoFrame? video_frame);
 
   // Resets the decoder for |stream_type| to a clean initialized state and
   // cancels any pending decrypt-and-decode operations immediately with ERROR.
   // This method can only be called after the corresponding decoder has been
   // successfully initialized.
   ResetDecoder(DemuxerStream.Type stream_type);
 
   // 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);
+
+  // Releases the shared memory.
+  ReleaseSharedBuffer(handle<shared_buffer> buffer, uint64 buffer_size);
 };