Class CMMFControllerImplementationInformation

class CMMFControllerImplementationInformation : public CMMFPluginImplementationInformation, private MTaggedDataParserClient;

Description

Contains controller plugin information retrieved from the ECom registry.

The object is created using a CImplementationInformation object retrieved from the ECom registry. All relevant data is copied out of the CImplementationInformation object, and its opaque data is parsed to provide the supplier, supported media IDs.

Notes for Format Plugin developers: The exact formats supported by the controller plugin are calculated by:

1. The formats supported by the controller plugin itself must be declared in separate entries in the controller plugin resource file. Two interface UIDs should be defined by the plugin writer - one for the play formats supported, the other for the record formats supported. The play formats are then listed as implementations of the play format interface uid, and likewise the record formats.

2. Format plugins (CMMFFormatEncode and CMMFFormatDecode) declare which controller plugin they extend. ECom is search for the format plugins that extend the controller plugin, and they are added to the list.

The opaque data section of the ECom plugin resource file must be in the format:

opaque_data = "<?>Data 1<?>Data 2<?>Data 3<?>Data 4[...]<?>Data N";

The <?> preceding the data determines the meaning of the data.  The following are the possible tags:

    <s> - Supplier - must be only one
    <i> - Media Id
    <p> - UID of play format 'interface' - must be only one
    <r> - UID of record format 'interface' - must be only one

UIDs must always be in hex in the format '0x12345678', must include the '0x' and be 10 characters long.

Derivation

• MTaggedDataParserClient - No description.

• CBase - Base class for all classes to be instantiated on the heap.

• CMMFPluginImplementationInformation - Abstract class that contains basic information about ECom Multimedia plugins.

• CMMFControllerImplementationInformation - Contains controller plugin information retrieved from the ECom registry.

Members

Defined in CMMFControllerImplementationInformation:

• HeapSpaceRequired()constReturns the heap space required by this controller.
• NewL(TUid)Constructs a new controller implementation information object.
• PlayFormats()constReturns the array of play formats supported by this controller.
• ProcessTaggedDataL(const TDesC8 &,const TDesC8 &)From MTaggedDataParserClient.
• RecordFormats()constReturns the array of record formats supported by this controller.

Inherited from CBase:

• Delete(CBase *)Deletes the specified object.
• Extension_(TUint,TAny *&,TAny *)Extension function
• operator new(TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TAny *)Initialises the object to binary zeroes.
• operator new(TUint,TLeave)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TLeave,TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TUint)Allocates the object from the heap and then initialises its contents to binary z...

Inherited from CMMFPluginImplementationInformation:

• DisplayName()constReturns the display name of this plugin implementation.
• Supplier()constReturns the name of the supplier of this plugin implementation, e.g. "Symbi...
• SupportedMediaIds()constReturns the array of media IDs supported by this plugin.
• SupportsMediaId(TUid)constTests whether this plugin supports aMediaId.
• SupportsSupplier(const TDesC &)constTests whether this plugin was supplied by aSupplier.
• Uid()constReturns the uid of this particular plugin implementation. This is the UID used t...
• Version()constReturns the version number of this plugin.
• iDisplayNameThe display name of this plugin.
• iMediaIdsThe media ids supported by this plugin.
• iSupplierThe supplier of this plugin.
• iUidThe UID of this plugin.
• iVersionThe version number of this plugin.

IMPORT_C static CMMFControllerImplementationInformation* NewL(TUid aUid);

Description

Constructs a new controller implementation information object.

Parameters

TUid aUid The Uid of the controller to obtain controller implementation information

Return value

CMMFControllerImplementationInformation * The new object created.

IMPORT_C const RMMFFormatImplInfoArray& PlayFormats() const;

Description

Returns the array of play formats supported by this controller.

Return value

const RPointerArray & The play formats supported.

IMPORT_C const RMMFFormatImplInfoArray& RecordFormats() const;

Description

Returns the array of record formats supported by this controller.

Return value

const RPointerArray & The record formats supported.

IMPORT_C TUint HeapSpaceRequired() const;

Description

Returns the heap space required by this controller.

Return value

TUint The heap space required.

protected: virtual void ProcessTaggedDataL(const TDesC8 &aTag, const TDesC8 &aData);

Description

From MTaggedDataParserClient.

Parameters

const TDesC8 &aTag const TDesC8 &aData