CMMFClip Class Reference

#include <mmf/server/mmfclip.h>

Link against: AdvancedAudioController.lib

class CMMFClip : public CBase

Inherits from

  • CMMFClip

    Detailed Description

    Abstract class to represent a source or sink that contains a multimedia clip (i.e. not a stream or hardware device).

    Typical examples are a file or an area of memory (descriptor).

    Constructor & Destructor Documentation

    CMMFClip ( TUid, TUid )

    CMMFClip(TUidaSourceType,
    TUidaSinkType
    )[protected, inline]

    Protected constructor.

    ParameterDescription
    aSourceTypeThe source type.
    aSinkTypeThe sink type.

    Member Function Documentation

    BytesFree ( )

    TInt64 BytesFree()[pure virtual]

    Returns the amount of space available for the clip.

    This is a virtual function that each derived class must implement.

    Returns: The amount of space available.

    Delete ( )

    TInt Delete()[inline, virtual]

    Deletes the clip.

    This should be overriden in the derived classes, the default version returns KErrNotSupported.

    Returns: An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.

    ReadBufferL ( TInt, CMMFBuffer *, TInt, MDataSink * )

    voidReadBufferL(TIntaLength,
    CMMFBuffer *aBuffer,
    TIntaPosition,
    MDataSink *aConsumer
    )[pure virtual]

    Reads aLength number of bytes of data from the offset, aPosition into the buffer, aBuffer. Intended for asynchronous usage.

    This is a virtual function that each derived class must implement.

    ParameterDescription
    aLengthThe number of bytes to read.
    aBufferThe buffer to read the data into.
    aPositionThe offset from which to start reading.
    aConsumerThe sink of tha data read from the clip. Will be informed of read if not NULL.

    ReadBufferL ( CMMFBuffer *, TInt, MDataSink * )

    voidReadBufferL(CMMFBuffer *aBuffer,
    TIntaPosition,
    MDataSink *aConsumer
    )[pure virtual]

    Reads the maximum number of bytes of data from the offset, aPosition into the buffer, aBuffer. Intended for asynchronous usage.

    This is a virtual function that each derived class must implement.

    ParameterDescription
    aBufferThe buffer to read the data into.
    aPositionThe offset from which to start reading.
    aConsumerThe sink of tha data read from the clip. Will be informed of read if not NULL.

    ReadBufferL ( CMMFBuffer *, TInt )

    voidReadBufferL(CMMFBuffer *aBuffer,
    TIntaPosition
    )[pure virtual]

    Reads the maximum number of bytes of data from the offset, aPosition into the buffer, aBuffer. Intended for synchronous usage.

    This is a virtual function that each derived class must implement.

    ParameterDescription
    aBufferThe buffer to read the data into.
    aPositionThe offset from which to start reading.

    SetSize ( TInt )

    TInt SetSize(TIntaSize)[inline, virtual]

    Sets the size of the clip. This should be overriden in the derived classes, the default version returns KErrNotSupported.

    ParameterDescription
    aSizeThe size of the clip.

    Returns: An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.

    Size ( )

    TInt Size()[pure virtual]

    Returns the size of the clip in bytes.

    This is a virtual function that each derived class must implement.

    Returns: The size of the clip.

    WriteBufferL ( TInt, CMMFBuffer *, TInt, MDataSource * )

    voidWriteBufferL(TIntaLength,
    CMMFBuffer *aBuffer,
    TIntaPosition,
    MDataSource *aSupplier
    )[pure virtual]

    Writes aLength number of bytes of data from the offset, aPosition from the buffer, aBuffer. Intended for asynchronous usage.

    This is a virtual function that each derived class must implement.

    ParameterDescription
    aLengthThe number of bytes to write.
    aBufferThe buffer to write the data into.
    aPositionThe offset from which to start writing.
    aSupplierThe source of the data writen to the clip. Will be informed of write if not NULL.

    WriteBufferL ( CMMFBuffer *, TInt, MDataSource * )

    voidWriteBufferL(CMMFBuffer *aBuffer,
    TIntaPosition,
    MDataSource *aSupplier
    )[pure virtual]

    Writes the maximum number of bytes of data from the offset, aPosition from the buffer, aBuffer. Intended for asynchronous usage.

    This is a virtual function that each derived class must implement.

    ParameterDescription
    aBufferThe buffer to write the data into.
    aPositionThe offset from which to start writing.
    aSupplierThe source of the data writen to the clip. Will be informed of write if not NULL.

    WriteBufferL ( CMMFBuffer *, TInt )

    voidWriteBufferL(CMMFBuffer *aBuffer,
    TIntaPosition
    )[pure virtual]

    Writes the maximum number of bytes of data from the offset, aPosition from the buffer, aBuffer. Intended for synchronous usage.

    This is a virtual function that each derived class must implement.

    ParameterDescription
    aBufferThe buffer to write the data into.
    aPositionThe offset from which to start writing.