Symbian^3 Application Developer Library >

MMMFDevVideoPlayObserver Class Reference

class MMMFDevVideoPlayObserver

The MMMFDevVideoPlayObserver mixin class defines a set of callback functions that the client using the MSL video API needs to implement. The callbacks are called in the context of the same thread that uses the API. DevVideo API methods can be safely called from the callbacks.

Public Member Functions
void MdvpoFatalError ( TInt )
void MdvpoInitComplete ( TInt )
void MdvpoNewBuffers ()
void MdvpoNewPictures ()
void MdvpoPictureLoss ()
void MdvpoPictureLoss (const TArray < TPictureId > &)
void MdvpoReferencePictureSelection (const TDesC8 &)
void MdvpoReturnPicture ( TVideoPicture *)
void MdvpoSliceLoss ( TUint , TUint , const TPictureId &)
void MdvpoStreamEnd ()
void MdvpoSupplementalInformation (const TDesC8 &, const TTimeIntervalMicroSeconds &, const TPictureId &)
void MdvpoTimedSnapshotComplete ( TInt , TPictureData *, const TTimeIntervalMicroSeconds &, const TPictureId &)

Member Functions Documentation

MdvpoFatalError(TInt)

void MdvpoFatalError ( TInt aError ) [pure virtual]

Reports a fatal decoding or playback error to the client. When these errors occur, decoding and playback is stopped automatically. The client must destroy the CMMFDevVideoPlay object and create a new instance before attempting to continue. Note that scenarios have been identified where MdvpoFatalError may get referenced at some point during the execution of a CMMFDevVideoPlay procedure. Therefore CMMFDevVideoPlay object should be deleted outside of MdvpoFatalError context in order to avoid accidental access to de-allocated CMMFDevVideoPlay data members.

Note that running out of processing power or encountering corrupted bitstream data should not be classified as errors if the decoder and post-processor can recover automatically.

Parameters

TInt aError "The error code."

MdvpoInitComplete(TInt)

void MdvpoInitComplete ( TInt aError ) [pure virtual]

Reports that DevVideoPlay initialization has completed. The interface can now be used for video playback.

Parameters

TInt aError "Initialization error code, KErrNone if no error occurred."

MdvpoNewBuffers()

void MdvpoNewBuffers ( ) [pure virtual]

Notifies the client that one or more new empty input buffers are available. The client can fetch the input buffer with GetBufferL().

MdvpoNewPictures()

void MdvpoNewPictures ( ) [pure virtual]

Notifies the client that one or more new output pictures are available. The client can then use GetNewPictureInfo() and NextPicture() to fetch the pictures.

MdvpoPictureLoss()

void MdvpoPictureLoss ( ) [pure virtual]

Back channel information from the decoder, indicating a picture loss without specifying the lost picture.

MdvpoPictureLoss(const TArray< TPictureId > &)

void MdvpoPictureLoss ( const TArray < TPictureId > & aPictures ) [pure virtual]

Back channel information from the decoder, indicating the pictures that have been lost.

Parameters

const TArray < TPictureId > & aPictures "Picture identifiers for the lost pictures. The reference is only valid until the method returns, and thus the data must be processed or copied immediately."

MdvpoReferencePictureSelection(const TDesC8 &)

void MdvpoReferencePictureSelection ( const TDesC8 & aSelectionData ) [pure virtual]

Back channel information from the decoder, indicating a reference picture selection request. The request is delivered as a coding-standard specific binary message. Reference picture selection can be used to select a pervious correctly transmitted picture to use as a reference in case later pictures have been lost.

Parameters

const TDesC8 & aSelectionData "The reference picture selection request message. The message format is coding-standard specific, and defined separately. The reference is only valid until the method returns, and thus the data must be processed or copied immediately."

MdvpoReturnPicture(TVideoPicture *)

void MdvpoReturnPicture ( TVideoPicture * aPicture ) [pure virtual]

Returns a used input video picture back to the caller. The picture memory can be re-used or freed.

Parameters

TVideoPicture * aPicture "The picture to return."

MdvpoSliceLoss(TUint, TUint, const TPictureId &)

void MdvpoSliceLoss ( TUint aFirstMacroblock,
TUint aNumMacroblocks,
const TPictureId & aPicture
) [pure virtual]

Back channel information from the decoder, indicating the loss of consecutive macroblocks in raster scan order.

Parameters

TUint aFirstMacroblock "The first lost macroblock. The macroblocks are numbered such that the macroblock in the upper left corner of the picture is considered macroblock number 1 and the number for each macroblock increases from left to right and then from top to bottom in raster-scan order." @param "aNumMacroblocks" "The number of lost macroblocks that are consecutive in raster-scan order." @param "aPicture" "The picture identifier for the picture where the macroblocks were lost. If the picture is not known, aPicture.iIdType is set to ENone. The reference is only valid until the method returns."
TUint aNumMacroblocks
const TPictureId & aPicture

MdvpoStreamEnd()

void MdvpoStreamEnd ( ) [pure virtual]

Reports that the input video stream end has been reached and all pictures have been processed. This method is only called after the client has called InputEnd(). No more output pictures will be available.

MdvpoSupplementalInformation(const TDesC8 &, const TTimeIntervalMicroSeconds &, const TPictureId &)

void MdvpoSupplementalInformation ( const TDesC8 & aData,
const TTimeIntervalMicroSeconds & aTimestamp,
const TPictureId & aPictureId
) [pure virtual]

Delivers supplemental information from a coded data unit. The information is codec-dependent.

Parameters

const TDesC8 & aData "The supplemental data. The reference is only valid until the method returns, and thus the data must be processed or copied immediately."
const TTimeIntervalMicroSeconds & aTimestamp "The presentation timestamp for the picture that the supplemental data is part of."
const TPictureId & aPictureId "Picture identifier for the picture. If a picture ID is not available, aPictureId.iIdType is set to ENone."

MdvpoTimedSnapshotComplete(TInt, TPictureData *, const TTimeIntervalMicroSeconds &, const TPictureId &)

void MdvpoTimedSnapshotComplete ( TInt aError,
TPictureData * aPictureData,
const TTimeIntervalMicroSeconds & aPresentationTimestamp,
const TPictureId & aPictureId
) [pure virtual]

Called when a timed snapshot request has been completed. When this method is called, the snapshot has been taken, and the memory reserved for the picture can be re-used or freed.

Parameters

TInt aError "An error code, KErrNone if no errors occurred. If an error occurred, the data in the snapshot may not be valid, but the memory can still be freed." @param "aPictureData" "The snapshot picture data." @param "aPresentationTimestamp" "The presentation timestamp for the snapshot picture. " @param "aPictureId" "Picture identifier for the picture. If a picture ID is not available, aPictureId.iIdType is set to ENone."
TPictureData * aPictureData
const TTimeIntervalMicroSeconds & aPresentationTimestamp
const TPictureId & aPictureId

Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.