Class RMMFDataPathProxy

class RMMFDataPathProxy : public RMMFSubThreadBase;

Description

Proxy class used to create a datapath in a new subthread.

Derivation

• RMMFSubThreadBase - No description.

• RMMFDataPathProxy - Proxy class used to create a datapath in a new subthread.

Members

Defined in RMMFDataPathProxy:

• AddDataSink(MDataSink *)Specify the data sink for this datapath.
• AddDataSource(MDataSource *)Specify the data source for this datapath.
• ClearPlayWindow()Removes a previously defined play window.
• Close()Deletes the datapath and shuts down the datapath proxy thread.
• CreateSubThread()Creates a subthread that will contain the datapath.
• GetPosition(TTimeIntervalMicroSeconds &)constGets the current position of the datapath in units of time.
• LoadDataPath()Load the datapath in the new thread. Use this method if the codec UID is not kno...
• LoadDataPath(TMediaId)Load the datapath in the new thread.
• LoadDataPath(TUid)Load the datapath in the new thread.
• LoadDataPath(TUid,TMediaId)Loads the datapath in the new thread.
• Pause()Pauses playing.
• Play()Transfer the datapath from the primed into the playing state.
• Prime()Transfer the datapath from the stopped into the primed state.
• RMMFDataPathProxy()Constuctor.
• SetPlayWindow(const TTimeIntervalMicroSeconds &,const TTimeIntervalMicroSeconds &)Sets the play window relative to the start of the entire clip.
• SetPosition(const TTimeIntervalMicroSeconds &)Sets the current position of the datapath in units of time.
• State(TInt &)Gets the current datapath state.
• Stop()Stops playing.

inline RMMFDataPathProxy();

Description

Constuctor.

IMPORT_C TInt CreateSubThread();

Description

Creates a subthread that will contain the datapath.

Return value

IMPORT_C TInt LoadDataPath();

Description

Load the datapath in the new thread. Use this method if the codec UID is not known and there is no datapath ambiguity, ie. only one datapath is possible.

Return value

IMPORT_C TInt LoadDataPath(TMediaId aMediaId);

Description

Load the datapath in the new thread.

Use this method if the codec UID is not known but the TMediaId can be used to select which codec to use.

Parameters

Return value

IMPORT_C TInt LoadDataPath(TUid aCodecUid);

Description

Load the datapath in the new thread.

Use this method if the codec UID is known and there is no datapath ambiguity, ie. only one datapath is possible.

Parameters

Return value

IMPORT_C TInt LoadDataPath(TUid aCodecUid, TMediaId aMediaId);

Description

Loads the datapath in the new thread.

Use this method if the codec UID is known and there is datapath ambiguity. The TMediaId will be used to choose the correct path.

Parameters

Return value

IMPORT_C TInt AddDataSource(MDataSource *aSource);

Description

Specify the data source for this datapath.

If the sink already exists, this function tries to establish a connection between the source and sink. Note that only one data source can be added to the datapath.

Parameters

Return value

IMPORT_C TInt AddDataSink(MDataSink *aSink);

Description

Specify the data sink for this datapath.

If the source already exists, this function tries to establish a connection between the source and the sink. Note that only one data sink can be added to the datapath.

Parameters

Return value

IMPORT_C TInt Prime();

Description

Transfer the datapath from the stopped into the primed state.

This function allocates buffers in preparation to play and must be called before calling PlayL().

Return value

IMPORT_C TInt Play();

Description

Transfer the datapath from the primed into the playing state.

This function starts an active scheduler play loop and can only play from the primed state.

Return value

IMPORT_C TInt Pause();

Description

Pauses playing.

This function transfers the datapath from the playing into the primed state and sends KMMFErrorCategoryDataPathGeneralError to the client if an error occurs.

Return value

IMPORT_C TInt Stop();

Description

Stops playing.

This function transfers the datapath from the primed into the stopped state and resets the data path position, but does not clean up buffers. It also sends KMMFErrorCategoryDataPathGeneralError to the client if an error occurs.

Return value

IMPORT_C TInt GetPosition(TTimeIntervalMicroSeconds &aPosition) const;

Description

Gets the current position of the datapath in units of time.

Parameters

Return value

IMPORT_C TInt SetPosition(const TTimeIntervalMicroSeconds &aPosition);

Description

Sets the current position of the datapath in units of time.

Parameters

Return value

IMPORT_C TInt SetPlayWindow(const TTimeIntervalMicroSeconds &aStart, const TTimeIntervalMicroSeconds &aEnd);

Description

Sets the play window relative to the start of the entire clip.

Parameters

Return value

IMPORT_C TInt ClearPlayWindow();

Description

Removes a previously defined play window.

Return value

IMPORT_C TInt State(TInt &aState);

Description

Gets the current datapath state.

Parameters

Return value

IMPORT_C void Close();

Description

Deletes the datapath and shuts down the datapath proxy thread.

Calls RMMFSubThreadBase::Shutdown(). This function will not return until the subthread has exited, or a timeout has occurred.