class H264Accelerator

Create a new H264Picture that the decoder client can use for decoding

and pass back to this accelerator for decoding or reference.

When the picture is no longer needed by decoder, it will just drop

its reference to it, and it may do so at any time.

Note that this may return nullptr if accelerator is not able to provide

any new pictures at given time. The decoder is expected to handle

this situation as normal and return from Decode() with kRanOutOfSurfaces.

Submit metadata for the current frame, providing the current |sps| and

|pps| for it, |dpb| has to contain all the pictures in DPB for current

frame, and |ref_pic_p0/b0/b1| as specified in the H264 spec. Note that

depending on the frame type, either p0, or b0 and b1 are used. |pic|

contains information about the picture for the current frame.

Note that this does not run decode in the accelerator and the decoder

is expected to follow this call with one or more SubmitSlice() calls

before calling SubmitDecode().

Returns kOk if successful, kFail if there are errors, or kTryAgain if

the accelerator needs additional data before being able to proceed.

|secure_handle| is a reference to the corresponding secure memory when

doing secure decoding on ARM. This is invoked instead of CreateAV1Picture

when doing secure decoding on ARM. Default implementation returns

nullptr.

TODO(jkardatzke): Remove this once we move to the V4L2 flat stateless

decoder and add a field to media::CodecPicture instead.

Provides the raw NALU data for an SPS. The |sps| passed to

SubmitFrameMetadata() is always the most recent SPS passed to

ProcessSPS() with the same |seq_parameter_set_id|.

Provides the raw NALU data for a PPS. The |pps| passed to

SubmitFrameMetadata() is always the most recent PPS passed to

ProcessPPS() with the same |pic_parameter_set_id|.

Used for handling CENCv1 streams where the entire slice header, except

for the NALU type byte, is encrypted. |data| represents the encrypted

ranges which will include any SEI NALUs along with the encrypted slice

NALU. |subsamples| specifies what is encrypted and should have just a

single clear byte for each and the rest is encrypted. |secure_handle| is

used on ARM to store the secure buffer reference to parse the header

from. |slice_header_out| should have its fields filled in upon successful

return. Returns kOk if successful, kFail if there are errors, or

kTryAgain if the accelerator needs additional data before being able to

proceed.

Submit one slice for the current frame, passing the current |pps| and

|pic| (same as in SubmitFrameMetadata()), the parsed header for the

current slice in |slice_hdr|, and the reordered |ref_pic_listX|,

as per H264 spec.

|data| pointing to the full slice (including the unparsed header) of

|size| in bytes.

|subsamples| specifies which part of the slice data is encrypted.

This must be called one or more times per frame, before SubmitDecode().

Note that |data| does not have to remain valid after this call returns.

Returns kOk if successful, kFail if there are errors, or kTryAgain if

the accelerator needs additional data before being able to proceed.

Execute the decode in hardware for |pic|, using all the slices and

metadata submitted via SubmitFrameMetadata() and SubmitSlice() since

the previous call to SubmitDecode().

Returns kOk if successful, kFail if there are errors, or kTryAgain if

the accelerator needs additional data before being able to proceed.

Schedule output (display) of |pic|. Note that returning from this

method does not mean that |pic| has already been outputted (displayed),

but guarantees that all pictures will be outputted in the same order

as this method was called for them. Decoder may drop its reference

to |pic| after calling this method.

Return true if successful.

Reset any current state that may be cached in the accelerator, dropping

any cached parameters/slices that have not been committed yet.

Notifies the accelerator whenever there is a new stream to process.

|stream| is the data in annex B format, which may include SPS and PPS

NALUs when there is a configuration change. The first frame must contain

the SPS and PPS NALUs. SPS and PPS NALUs may not be encrypted.

|decrypt_config| is the config for decrypting the stream. The accelerator

should use |decrypt_config| to keep track of the parts of |stream| that

are encrypted. If kTryAgain is returned, the decoder will retry this call

later. This method has a default implementation that returns

kNotSupported.

Notifies whether or not the current platform requires reference lists.

In general, implementations don't need it.

Methods may return kTryAgain if they need additional data (provided

independently) in order to proceed. Examples are things like not having

an appropriate key to decode encrypted content, or needing to wait

until hardware buffers are available. This is not considered an

unrecoverable error, but rather a pause to allow an application to

independently provide the required data. When H264Decoder::Decode()

is called again, it will attempt to resume processing of the stream

by calling the same method again.