• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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 CONTENT_COMMON_GPU_MEDIA_DXVA_VIDEO_DECODE_ACCELERATOR_H_
6 #define CONTENT_COMMON_GPU_MEDIA_DXVA_VIDEO_DECODE_ACCELERATOR_H_
7 
8 #include <d3d9.h>
9 #include <dxva2api.h>
10 #include <list>
11 #include <map>
12 #include <mfidl.h>
13 #include <vector>
14 
15 #include "base/compiler_specific.h"
16 #include "base/memory/linked_ptr.h"
17 #include "base/threading/non_thread_safe.h"
18 #include "base/win/scoped_comptr.h"
19 #include "content/common/content_export.h"
20 #include "content/common/gpu/media/video_decode_accelerator_impl.h"
21 #include "media/video/video_decode_accelerator.h"
22 
23 interface IMFSample;
24 interface IDirect3DSurface9;
25 
26 namespace content {
27 
28 // Class to provide a DXVA 2.0 based accelerator using the Microsoft Media
29 // foundation APIs via the VideoDecodeAccelerator interface.
30 // This class lives on a single thread and DCHECKs that it is never accessed
31 // from any other.
32 class CONTENT_EXPORT DXVAVideoDecodeAccelerator
33     : public VideoDecodeAcceleratorImpl,
34       NON_EXPORTED_BASE(public base::NonThreadSafe) {
35  public:
36   enum State {
37     kUninitialized,   // un-initialized.
38     kNormal,          // normal playing state.
39     kResetting,       // upon received Reset(), before ResetDone()
40     kStopped,         // upon output EOS received.
41     kFlushing,        // upon flush request received.
42   };
43 
44   // Does not take ownership of |client| which must outlive |*this|.
45   explicit DXVAVideoDecodeAccelerator(
46       media::VideoDecodeAccelerator::Client* client,
47       const base::Callback<bool(void)>& make_context_current);
48   virtual ~DXVAVideoDecodeAccelerator();
49 
50   // media::VideoDecodeAccelerator implementation.
51   virtual bool Initialize(media::VideoCodecProfile profile) OVERRIDE;
52   virtual void Decode(const media::BitstreamBuffer& bitstream_buffer) OVERRIDE;
53   virtual void AssignPictureBuffers(
54       const std::vector<media::PictureBuffer>& buffers) OVERRIDE;
55   virtual void ReusePictureBuffer(int32 picture_buffer_id) OVERRIDE;
56   virtual void Flush() OVERRIDE;
57   virtual void Reset() OVERRIDE;
58   virtual void Destroy() OVERRIDE;
59 
60  private:
61   typedef void* EGLConfig;
62   typedef void* EGLSurface;
63   // Creates and initializes an instance of the D3D device and the
64   // corresponding device manager. The device manager instance is eventually
65   // passed to the IMFTransform interface implemented by the h.264 decoder.
66   bool CreateD3DDevManager();
67 
68   // Creates, initializes and sets the media types for the h.264 decoder.
69   bool InitDecoder(media::VideoCodecProfile profile);
70 
71   // Validates whether the h.264 decoder supports hardware video acceleration.
72   bool CheckDecoderDxvaSupport();
73 
74   // Returns information about the input and output streams. This includes
75   // alignment information, decoder support flags, minimum sample size, etc.
76   bool GetStreamsInfoAndBufferReqs();
77 
78   // Registers the input and output media types on the h.264 decoder. This
79   // includes the expected input and output formats.
80   bool SetDecoderMediaTypes();
81 
82   // Registers the input media type for the h.264 decoder.
83   bool SetDecoderInputMediaType();
84 
85   // Registers the output media type for the h.264 decoder.
86   bool SetDecoderOutputMediaType(const GUID& subtype);
87 
88   // Passes a command message to the decoder. This includes commands like
89   // start of stream, end of stream, flush, drain the decoder, etc.
90   bool SendMFTMessage(MFT_MESSAGE_TYPE msg, int32 param);
91 
92   // The bulk of the decoding happens here. This function handles errors,
93   // format changes and processes decoded output.
94   void DoDecode();
95 
96   // Invoked when we have a valid decoded output sample. Retrieves the D3D
97   // surface and maintains a copy of it which is passed eventually to the
98   // client when we have a picture buffer to copy the surface contents to.
99   bool ProcessOutputSample(IMFSample* sample);
100 
101   // Processes pending output samples by copying them to available picture
102   // slots.
103   void ProcessPendingSamples();
104 
105   // Helper function to notify the accelerator client about the error.
106   void StopOnError(media::VideoDecodeAccelerator::Error error);
107 
108   // Transitions the decoder to the uninitialized state. The decoder will stop
109   // accepting requests in this state.
110   void Invalidate();
111 
112   // Notifies the client that the input buffer identifed by input_buffer_id has
113   // been processed.
114   void NotifyInputBufferRead(int input_buffer_id);
115 
116   // Notifies the client that initialize was completed.
117   void NotifyInitializeDone();
118 
119   // Notifies the client that the decoder was flushed.
120   void NotifyFlushDone();
121 
122   // Notifies the client that the decoder was reset.
123   void NotifyResetDone();
124 
125   // Requests picture buffers from the client.
126   void RequestPictureBuffers(int width, int height);
127 
128   // Notifies the client about the availability of a picture.
129   void NotifyPictureReady(const media::Picture& picture);
130 
131   // Sends pending input buffer processed acks to the client if we don't have
132   // output samples waiting to be processed.
133   void NotifyInputBuffersDropped();
134 
135   // Decodes pending input buffers.
136   void DecodePendingInputBuffers();
137 
138   // Helper for handling the Flush operation.
139   void FlushInternal();
140 
141   // Helper for handling the Decode operation.
142   void DecodeInternal(const base::win::ScopedComPtr<IMFSample>& input_sample);
143 
144   // Handles mid stream resolution changes.
145   void HandleResolutionChanged(int width, int height);
146 
147   struct DXVAPictureBuffer;
148   typedef std::map<int32, linked_ptr<DXVAPictureBuffer> > OutputBuffers;
149 
150   // Tells the client to dismiss the stale picture buffers passed in.
151   void DismissStaleBuffers(const OutputBuffers& picture_buffers);
152 
153   // To expose client callbacks from VideoDecodeAccelerator.
154   media::VideoDecodeAccelerator::Client* client_;
155 
156   base::win::ScopedComPtr<IMFTransform> decoder_;
157 
158   base::win::ScopedComPtr<IDirect3D9Ex> d3d9_;
159   base::win::ScopedComPtr<IDirect3DDevice9Ex> device_;
160   base::win::ScopedComPtr<IDirect3DDeviceManager9> device_manager_;
161   base::win::ScopedComPtr<IDirect3DQuery9> query_;
162   // Ideally the reset token would be a stack variable which is used while
163   // creating the device manager. However it seems that the device manager
164   // holds onto the token and attempts to access it if the underlying device
165   // changes.
166   // TODO(ananta): This needs to be verified.
167   uint32 dev_manager_reset_token_;
168 
169   // The EGL config to use for decoded frames.
170   EGLConfig egl_config_;
171 
172   // Current state of the decoder.
173   State state_;
174 
175   MFT_INPUT_STREAM_INFO input_stream_info_;
176   MFT_OUTPUT_STREAM_INFO output_stream_info_;
177 
178   // Contains information about a decoded sample.
179   struct PendingSampleInfo {
180     PendingSampleInfo(int32 buffer_id, IMFSample* sample);
181     ~PendingSampleInfo();
182 
183     int32 input_buffer_id;
184     base::win::ScopedComPtr<IMFSample> output_sample;
185   };
186 
187   typedef std::list<PendingSampleInfo> PendingOutputSamples;
188 
189   // List of decoded output samples.
190   PendingOutputSamples pending_output_samples_;
191 
192   // This map maintains the picture buffers passed the client for decoding.
193   // The key is the picture buffer id.
194   OutputBuffers output_picture_buffers_;
195 
196   // Set to true if we requested picture slots from the client.
197   bool pictures_requested_;
198 
199   // Counter which holds the number of input packets before a successful
200   // decode.
201   int inputs_before_decode_;
202 
203   // List of input samples waiting to be processed.
204   typedef std::list<base::win::ScopedComPtr<IMFSample>> PendingInputs;
205   PendingInputs pending_input_buffers_;
206 
207   // Callback to set the correct gl context.
208   base::Callback<bool(void)> make_context_current_;
209 };
210 
211 }  // namespace content
212 
213 #endif  // CONTENT_COMMON_GPU_MEDIA_DXVA_VIDEO_DECODE_ACCELERATOR_H_
214