MMMFSurfaceEventHandler Class Reference

class MMMFSurfaceEventHandler

Clients intending to use window-less graphics surfaces need to handle graphics surface specific events generated by the MultiMedia Framework (MMF). The MMMFSurfaceEventHandler interface allows client to receive these graphics surface specific events. A client intending to use the CVideoPlayerUtility2::AddDisplayL API must implement this interface.

CVideoPlayerUtility2

Member Functions Documentation

MmsehRemoveSurface(const TSurfaceId &)

voidMmsehRemoveSurface(const TSurfaceId &aId)[pure virtual]

MmsehSurfaceRemoved is called when the MultiMedia Framework indicates that the surface is to be removed. Clients should stop using the graphics surface identified by aId before returning from the callback. Further, clients should be prepared to receive a MmsehSurfaceCreated callback event with a new graphics surface to use.

Parameters

const TSurfaceId & aIdSurface id of graphics surface to be removed.

MmsehSurfaceCreated(TInt, const TSurfaceId &, const TRect &, TVideoAspectRatio)

voidMmsehSurfaceCreated(TIntaDisplayId,
const TSurfaceId &aId,
const TRect &aCropRect,
TVideoAspectRatioaAspectRatio
)[pure virtual]

MmsehSurfaceCreated is called when a graphics surface has been created on an added display. Clients will only be notified of surfaces created on displays that they have added. MMF still owns the graphics surface and can request the surface to be released by the client. Before this method is called by CVideoPlayerUtility2 the graphics surface is registered with the Window Server.

TVideoAspectRatio

Parameters

TInt aDisplayIdDisplay id the surface was created on.
const TSurfaceId & aIdsurface Id of graphics surface created.
const TRect & aCropRectCrop rectangle. The crop rectangle is the area of graphics surface containing viewable video.
TVideoAspectRatio aAspectRatioAspect ratio of video.

MmsehSurfaceParametersChanged(const TSurfaceId &, const TRect &, TVideoAspectRatio)

voidMmsehSurfaceParametersChanged(const TSurfaceId &aId,
const TRect &aCropRect,
TVideoAspectRatioaAspectRatio
)[pure virtual]

MmsehSurfaceParametersChanged is called when either crop rectangle or aspect ratio of the surface changes.

Parameters

const TSurfaceId & aIdSurface id of graphics surface with changed parameters.
const TRect & aCropRectNew crop rectangle, this may be identical to previous value. The crop rectangle is the area of graphics surface containing viewable video.
TVideoAspectRatio aAspectRatioNew aspect ratio of video, this may be identical to previous value.