Pepper: Change PPB_VideoDecoder::Reset behavior so plugin always manages textures.

ppapi/cpp/video_decoder.h

 // Copyright (c) 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.
 
 #ifndef PPAPI_CPP_VIDEO_DECODER_H_
 #define PPAPI_CPP_VIDEO_DECODER_H_
 
 #include "ppapi/c/pp_codecs.h"
 #include "ppapi/c/pp_size.h"
 #include "ppapi/cpp/completion_callback.h"
@@ skipping 131 matching lines @@
   /// decoder.
   void RecyclePicture(const PP_VideoPicture& picture);
 
   /// Flushes the decoder. The plugin should call Flush() when it reaches the
   /// end of its video stream in order to stop cleanly. The decoder will run any
   /// pending Decode() call to completion. The plugin should make no further
   /// calls to the decoder other than GetPicture() and RecyclePicture() until
   /// the decoder signals completion by running |callback|. Just before
   /// completion, any pending GetPicture() call will complete by running its
   /// callback with result PP_ERROR_ABORTED to signal that no more pictures are
-  /// available. The plugin should recycle any pictures it is using before
-  /// resuming decoding.
+  /// available. Any pictures held by the plugin remain valid during and after
+  /// the flush and should be recycled back to the decoder.
   ///
   /// @param[in] callback A <code>CompletionCallback</code> to be called on
   /// completion.
   ///
   /// @return An int32_t containing an error code from <code>pp_errors.h</code>.
   /// Returns PP_ERROR_FAILED if the decoder isn't initialized.
   int32_t Flush(const CompletionCallback& callback);
 
   /// Resets the decoder as quickly as possible. The plugin can call Reset() to
   /// skip to another position in the video stream. After Reset() returns, any
   /// pending calls to Decode() and GetPicture()) abort, causing their callbacks
   /// to run with PP_ERROR_ABORTED. The plugin should not make further calls to
-  /// the decoder until the decoder signals completion by running |callback|.
-  /// The pictures in use by the plugin remain valid until decoding is resumed,
-  /// but need not be recycled.
+  /// the decoder other than RecyclePicture() until the decoder signals
+  /// completion by running |callback|. Any pictures held by the plugin remain
+  /// valid during and after the reset and should be recycled back to the
+  /// decoder.
   ///
   /// @param[in] callback A <code>CompletionCallback</code> to be called on
   /// completion.
   ///
   /// @return An int32_t containing an error code from <code>pp_errors.h</code>.
     /// Returns PP_ERROR_FAILED if the decoder isn't initialized.
 int32_t Reset(const CompletionCallback& callback);
 };
 
 }  // namespace pp
 
 #endif  // PPAPI_CPP_VIDEO_DECODER_H_