1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/os/mm/mmlibs/mmfw/inc/mmf/ControllerFramework/mmfcontrollerpluginresolver.h Fri Jun 15 03:10:57 2012 +0200
1.3 @@ -0,0 +1,1426 @@
1.4 +// Copyright (c) 2002-2009 Nokia Corporation and/or its subsidiary(-ies).
1.5 +// All rights reserved.
1.6 +// This component and the accompanying materials are made available
1.7 +// under the terms of "Eclipse Public License v1.0"
1.8 +// which accompanies this distribution, and is available
1.9 +// at the URL "http://www.eclipse.org/legal/epl-v10.html".
1.10 +//
1.11 +// Initial Contributors:
1.12 +// Nokia Corporation - initial contribution.
1.13 +//
1.14 +// Contributors:
1.15 +//
1.16 +// Description:
1.17 +// mmf\common\mmfcontrollerpluginresolver.h
1.18 +//
1.19 +//
1.20 +
1.21 +#ifndef MMF_COMMON_MMFCONTROLLERPLUGINRESOLVER_H
1.22 +#define MMF_COMMON_MMFCONTROLLERPLUGINRESOLVER_H
1.23 +
1.24 +#include <ecom/ecom.h>
1.25 +#include <e32base.h>
1.26 +#include <apmstd.h>
1.27 +
1.28 +/**
1.29 +@publishedAll
1.30 +@released
1.31 +
1.32 +Default heap size for the controller thread
1.33 +*/
1.34 +const TUint KMMFDefaultControllerThreadHeapSize = 0x100000; //1MB
1.35 +
1.36 +
1.37 +class CMMFFormatImplementationInformation;
1.38 +
1.39 +/**
1.40 +@publishedAll
1.41 +@released
1.42 +
1.43 +Array of CMMFFormatImplementationInformation
1.44 +*/
1.45 +typedef RPointerArray<CMMFFormatImplementationInformation> RMMFFormatImplInfoArray;
1.46 +
1.47 +class CMMFControllerImplementationInformation;
1.48 +
1.49 +/**
1.50 +@publishedAll
1.51 +@released
1.52 +
1.53 +Array of CMMFControllerImplementationInformation
1.54 +*/
1.55 +typedef RPointerArray<CMMFControllerImplementationInformation> RMMFControllerImplInfoArray;
1.56 +
1.57 +class CMatchData;
1.58 +
1.59 +class CDesC8Array;
1.60 +
1.61 +/**
1.62 +@publishedAll
1.63 +
1.64 +Abstract class that contains basic information about ECom Multimedia plugins.
1.65 +
1.66 +@released
1.67 +@since 7.0s
1.68 +*/
1.69 +class CMMFPluginImplementationInformation : public CBase
1.70 + {
1.71 +public:
1.72 +
1.73 + /**
1.74 + Returns the uid of this particular plugin implementation.
1.75 + This is the UID used to instantiate this multimedia plugin.
1.76 +
1.77 + @return The implementation uid.
1.78 +
1.79 + @since 7.0s
1.80 + */
1.81 + IMPORT_C TUid Uid() const;
1.82 +
1.83 + /**
1.84 + Returns the display name of this plugin implementation.
1.85 +
1.86 + @return The display name.
1.87 +
1.88 + @since 7.0s
1.89 + */
1.90 + IMPORT_C const TDesC& DisplayName() const;
1.91 +
1.92 + /**
1.93 + Returns the name of the supplier of this plugin implementation, e.g. "Symbian".
1.94 +
1.95 + @return The plugin supplier.
1.96 +
1.97 + @since 7.0s
1.98 + */
1.99 + IMPORT_C const TDesC& Supplier() const;
1.100 +
1.101 + /**
1.102 + Returns the version number of this plugin.
1.103 +
1.104 + @return The version number.
1.105 +
1.106 + @since 7.0s
1.107 + */
1.108 + IMPORT_C TInt Version() const;
1.109 +
1.110 + /**
1.111 + Returns the array of media IDs supported by this plugin.
1.112 +
1.113 + The media ID can be used by clients to determine whether the plugin supports audio or
1.114 + video data (or both). A UID is used for the media ID to provide future extensibility.
1.115 +
1.116 + @return The array of media IDs.
1.117 +
1.118 + @since 7.0s
1.119 + */
1.120 + IMPORT_C const RArray<TUid>& SupportedMediaIds() const;
1.121 +
1.122 + /**
1.123 + Tests whether this plugin was supplied by aSupplier.
1.124 +
1.125 + @param aSupplier
1.126 + The required supplier.
1.127 +
1.128 + @return A boolean indicating if this plugin was supplied by aSupplier. ETrue if this plugin was supplied
1.129 + by aSupplier, EFalse if not.
1.130 +
1.131 + @since 7.0s
1.132 + */
1.133 + IMPORT_C TBool SupportsSupplier(const TDesC& aSupplier) const;
1.134 +
1.135 + /**
1.136 + Tests whether this plugin supports aMediaId.
1.137 +
1.138 + @param aMediaId
1.139 + The required media id.
1.140 +
1.141 + @return A boolean indicating if the plugin supports aMediaId. ETrue if this plugin supports aMediaId, EFalse if not.
1.142 +
1.143 + @since 7.0s
1.144 + */
1.145 + IMPORT_C TBool SupportsMediaId(TUid aMediaId) const;
1.146 +
1.147 + /**
1.148 + Destructor.
1.149 + */
1.150 + virtual ~CMMFPluginImplementationInformation();
1.151 +
1.152 +protected:
1.153 +
1.154 + /**
1.155 + Constructor.
1.156 + */
1.157 + CMMFPluginImplementationInformation();
1.158 +
1.159 + /**
1.160 + Sets the supplier. Takes a copy of aData.
1.161 + */
1.162 + void SetSupplierL(const TDesC8& aData);
1.163 +
1.164 + /**
1.165 + Adds a media id. aData is parsed to find the uid of the media id to be added.
1.166 + */
1.167 + void AddMediaIdL(const TDesC8& aData);
1.168 +
1.169 +protected:
1.170 +
1.171 + /**
1.172 + The UID of this plugin.
1.173 + */
1.174 + TUid iUid;
1.175 +
1.176 + /**
1.177 + The display name of this plugin.
1.178 + */
1.179 + HBufC* iDisplayName;
1.180 +
1.181 + /**
1.182 + The supplier of this plugin.
1.183 + */
1.184 + HBufC* iSupplier;
1.185 +
1.186 + /**
1.187 + The version number of this plugin.
1.188 + */
1.189 + TInt iVersion;
1.190 +
1.191 + /**
1.192 + The media ids supported by this plugin.
1.193 + */
1.194 + RArray<TUid> iMediaIds;
1.195 + };
1.196 +
1.197 +#ifndef SYMBIAN_ENABLE_SPLIT_HEADERS
1.198 +#include <mmf/common/taggeddataparser.h>
1.199 +#endif
1.200 +
1.201 +/**
1.202 +@publishedAll
1.203 +
1.204 +Interface to be implemented by customers of the class TaggedDataParser.
1.205 +*/
1.206 +class MTaggedDataParserClient
1.207 + {
1.208 +public:
1.209 + virtual void ProcessTaggedDataL(const TDesC8& aTag, const TDesC8& aData) = 0;
1.210 + };
1.211 +
1.212 +/**
1.213 +@publishedAll
1.214 +@released
1.215 +
1.216 +Contains format support information retrieved from the ECom registry.
1.217 +
1.218 +An object of this type may describe either a concrete format plugin (ie a CMMFFormatEncode or a
1.219 +CMMFFormatDecode implementation) or a format supported by a controller plugin.
1.220 +
1.221 +The object is created using a CImplementationInformation object retrieved from the ECom registry.
1.222 +All relevant data is copied out of the CImplementationInformation object, and its opaque data is
1.223 +parsed to provide the supplier, supported media ids, supported mime types, supported file extensions,
1.224 +and supported header data matches.
1.225 +
1.226 +Notes for Format Plugin developers:
1.227 +@code
1.228 +The opaque data section of the ECom plugin resource file must be in the format:
1.229 +
1.230 +opaque_data = "<?>Data 1<?>Data 2<?>Data 3<?>Data 4[...]<?>Data N";
1.231 +
1.232 +The <?> preceding the data determines the meaning of the data. The following are the possible tags:
1.233 +
1.234 + <s> - Supplier
1.235 + <i> - Media Id
1.236 + <m> - Mime Type
1.237 + <e> - File Extension
1.238 + <h> - Header Data
1.239 + <c> - Custom Interfaces
1.240 +
1.241 +UIDs must always be in hex in the format '0x12345678', must include the '0x' and be 10 characters long
1.242 +@endcode
1.243 +
1.244 +@since 7.0s
1.245 +*/
1.246 +class CMMFFormatImplementationInformation : public CMMFPluginImplementationInformation, MTaggedDataParserClient
1.247 + {
1.248 +public:
1.249 + /**
1.250 + Constructs a new format implementation information object.
1.251 +
1.252 + @param aImplInfo
1.253 + The ECOM implementation information
1.254 +
1.255 + @return The new object created.
1.256 +
1.257 + @since 7.0s
1.258 + */
1.259 + static CMMFFormatImplementationInformation* NewL(const CImplementationInformation& aImplInfo);
1.260 +
1.261 + /**
1.262 + Constructs a new format implementation information object.
1.263 +
1.264 + @param aImplInfo
1.265 + The ECOM implementation information
1.266 +
1.267 + @return The new object created. Note that this will be on the cleanup stack.
1.268 +
1.269 + @since 7.0s
1.270 + */
1.271 + static CMMFFormatImplementationInformation* NewLC(const CImplementationInformation& aImplInfo);
1.272 +
1.273 + /**
1.274 + Destructor
1.275 + */
1.276 + virtual ~CMMFFormatImplementationInformation();
1.277 +
1.278 + /**
1.279 + Returns the array of supported file extensions.
1.280 +
1.281 + @return The array of file extensions.
1.282 + @since 7.0s
1.283 + */
1.284 + IMPORT_C const CDesC8Array& SupportedFileExtensions() const;
1.285 +
1.286 + /**
1.287 + Returns the array of supported mime types.
1.288 +
1.289 + @return The array of mime types.
1.290 +
1.291 + @since 7.0s
1.292 + */
1.293 + IMPORT_C const CDesC8Array& SupportedMimeTypes() const;
1.294 +
1.295 + /**
1.296 + Returns the array of supported header data matches.
1.297 +
1.298 + @return The array of header data.
1.299 + @since 7.0s
1.300 + */
1.301 + IMPORT_C const CDesC8Array& SupportedHeaderData() const;
1.302 +
1.303 + /**
1.304 + Tests whether this format provides support for the specified file extension, aFileExtension.
1.305 +
1.306 + @param aFileExtension
1.307 + The requested file extension. Must be the extension only, and contain the dot '.'
1.308 +
1.309 + @return A boolean indicating if the specified file extension is supported. ETrue if this format provides
1.310 + the required support, EFalse if it does not.
1.311 +
1.312 + @since 7.0s
1.313 + */
1.314 + IMPORT_C TBool SupportsFileExtension(const TDesC8& aFileExtension) const;
1.315 +
1.316 + /**
1.317 + Tests whether this format provides support for aMimeType.
1.318 +
1.319 + @param aMimeType
1.320 + The requested mime type.
1.321 +
1.322 + @return A boolean indicating if the format is supported. ETrue if this format provides the required support, EFalse if not.
1.323 +
1.324 + @since 7.0s
1.325 + */
1.326 + IMPORT_C TBool SupportsMimeType(const TDesC8& aMimeType) const;
1.327 +
1.328 + /**
1.329 + Tests whether this format provides support for aHeaderData.
1.330 + aHeaderData is searched for each chunk supported by this format.
1.331 +
1.332 + @param aHeaderData
1.333 + The requested header data.
1.334 +
1.335 + @return A boolean indicating if aHeaderData is supported. ETrue if this format provides the required support, EFalse if not.
1.336 +
1.337 + @since 7.0s
1.338 + */
1.339 + IMPORT_C TBool SupportsHeaderDataL(const TDesC8& aHeaderData) const;
1.340 +
1.341 + /**
1.342 + Tests whether this format provides support for Custom Interfaces.
1.343 +
1.344 + @return A boolean indicating if Custom Interfaces are supported. ETrue if this format provides the required support, EFalse if not.
1.345 + */
1.346 + IMPORT_C TBool SupportsCustomInterfaces() const;
1.347 +
1.348 +protected:
1.349 +
1.350 + /**
1.351 + Constructor
1.352 + */
1.353 + CMMFFormatImplementationInformation();
1.354 +
1.355 + /**
1.356 + 2nd phase constructor
1.357 + */
1.358 + void ConstructL(const CImplementationInformation& aImplInfo);
1.359 +
1.360 + /**
1.361 + Adds a file extension to the array of extensions supported by this format.
1.362 + */
1.363 + void AddFileExtensionL(const TDesC8& aData);
1.364 +
1.365 + /**
1.366 + Adds a mime type to the array of types supported by this format.
1.367 + */
1.368 + void AddMimeTypeL(const TDesC8& aData);
1.369 +
1.370 + /**
1.371 + Adds a chunk of header data to the array of chunks supported by this format.
1.372 + */
1.373 + void AddHeaderDataL(const TDesC8& aData);
1.374 +
1.375 + /**
1.376 + from MTaggedDataParserClient
1.377 + */
1.378 + void ProcessTaggedDataL(const TDesC8& aTag, const TDesC8& aData);
1.379 +
1.380 +private:
1.381 + class CBody;
1.382 + /**
1.383 + CMMFFormatImplementationInformation body
1.384 + */
1.385 + CBody* iBody;
1.386 + };
1.387 +
1.388 +
1.389 +/**
1.390 +@publishedAll
1.391 +@released
1.392 +
1.393 +Contains controller plugin information retrieved from the ECom registry.
1.394 +
1.395 +The object is created using a CImplementationInformation object retrieved from the ECom registry.
1.396 +All relevant data is copied out of the CImplementationInformation object, and its opaque data is
1.397 +parsed to provide the supplier, supported media IDs.
1.398 +
1.399 +Notes for Format Plugin developers:
1.400 +The exact formats supported by the controller plugin are calculated by:
1.401 +
1.402 +1. The formats supported by the controller plugin itself must be declared in separate entries in the
1.403 +controller plugin resource file. Two interface UIDs should be defined by the plugin writer - one
1.404 +for the play formats supported, the other for the record formats supported. The play formats are
1.405 +then listed as implementations of the play format interface uid, and likewise the record formats.
1.406 +
1.407 +2. Format plugins (CMMFFormatEncode and CMMFFormatDecode) declare which controller plugin they
1.408 +extend. ECom is search for the format plugins that extend the controller plugin, and they
1.409 +are added to the list.
1.410 +
1.411 +The opaque data section of the ECom plugin resource file must be in the format:
1.412 +@code
1.413 +
1.414 +opaque_data = "<?>Data 1<?>Data 2<?>Data 3<?>Data 4[...]<?>Data N";
1.415 +
1.416 +The <?> preceding the data determines the meaning of the data. The following are the possible tags:
1.417 +
1.418 + <s> - Supplier - must be only one
1.419 + <i> - Media Id
1.420 + <p> - UID of play format 'interface' - must be only one
1.421 + <r> - UID of record format 'interface' - must be only one
1.422 +
1.423 +UIDs must always be in hex in the format '0x12345678', must include the '0x' and be 10 characters long.
1.424 +@endcode
1.425 +
1.426 +@since 7.0s
1.427 +*/
1.428 +class CMMFControllerImplementationInformation : public CMMFPluginImplementationInformation, MTaggedDataParserClient
1.429 + {
1.430 +public:
1.431 +
1.432 + /**
1.433 + Constructs a new controller implementation information object.
1.434 +
1.435 + @param aImplInfo
1.436 + The ECOM implementation information.
1.437 +
1.438 + @return The new object created.
1.439 +
1.440 + @internalTechnology
1.441 +
1.442 + @since 7.0s
1.443 + */
1.444 + static CMMFControllerImplementationInformation* NewL(const CImplementationInformation& aImplInfo);
1.445 +
1.446 + /**
1.447 + Constructs a new controller implementation information object.
1.448 +
1.449 + Note:
1.450 + The new object will be on the cleanup stack.
1.451 +
1.452 + @param aImplInfo
1.453 + The ECOM implementation information
1.454 +
1.455 + @return The new object created.
1.456 +
1.457 + @internalTechnology
1.458 +
1.459 + @since 7.0s
1.460 + */
1.461 + static CMMFControllerImplementationInformation* NewLC(const CImplementationInformation& aImplInfo);
1.462 +
1.463 + /**
1.464 + Constructs a new controller implementation information object.
1.465 +
1.466 + @param aUid
1.467 + The Uid of the controller to obtain controller implementation information
1.468 +
1.469 + @return The new object created.
1.470 +
1.471 + @since 7.0s
1.472 + */
1.473 + IMPORT_C static CMMFControllerImplementationInformation* NewL(TUid aUid);
1.474 +
1.475 + /**
1.476 + Destructor.
1.477 +
1.478 + @internalTechnology
1.479 + */
1.480 + ~CMMFControllerImplementationInformation();
1.481 +
1.482 + /**
1.483 + Returns the array of play formats supported by this controller.
1.484 +
1.485 + @return The play formats supported.
1.486 +
1.487 + @since 7.0s
1.488 + */
1.489 + IMPORT_C const RMMFFormatImplInfoArray& PlayFormats() const;
1.490 +
1.491 + /**
1.492 + Returns the array of record formats supported by this controller.
1.493 +
1.494 + @return The record formats supported.
1.495 +
1.496 + @since 7.0s
1.497 + */
1.498 + IMPORT_C const RMMFFormatImplInfoArray& RecordFormats() const;
1.499 +
1.500 + /**
1.501 + Returns the heap space required by this controller.
1.502 +
1.503 + @return The heap space required.
1.504 +
1.505 + @since 7.0s
1.506 + */
1.507 + IMPORT_C TUint HeapSpaceRequired() const;
1.508 +
1.509 + /**
1.510 + Queries the ECom registry for the play formats supported.
1.511 +
1.512 + @internalTechnology
1.513 + */
1.514 + void GetPlayFormatsL();
1.515 +
1.516 + /**
1.517 + Queries the ECom registry for the record formats supported.
1.518 +
1.519 + @internalTechnology
1.520 + */
1.521 + void GetRecordFormatsL();
1.522 +
1.523 + /**
1.524 + Returns the uri schemes of this plugin.
1.525 +
1.526 + @return The array of uri schemes.
1.527 +
1.528 + @internalTechnology
1.529 + */
1.530 + IMPORT_C const CDesC8Array& SupportedUriSchemes() const;
1.531 +
1.532 + /**
1.533 + Tests whether the plugin supports aUriScheme.
1.534 +
1.535 + @param aUriScheme
1.536 + The required Uri Scheme.
1.537 +
1.538 + @return A boolean indicating if the plugin supports aUriScheme. ETrue if this plugin supports aUriScheme, EFalse if not.
1.539 +
1.540 + @internalTechnology
1.541 + */
1.542 + IMPORT_C TBool SupportsUriScheme(const TDesC8& aUriScheme) const;
1.543 +
1.544 + /**
1.545 + Tests whether the controller plugin supports url
1.546 +
1.547 + @return A boolean indicating if the plugin supports url. ETrue for uri supporting controller, EFalse if not.
1.548 +
1.549 + @internalTechnology
1.550 + */
1.551 + IMPORT_C TBool SupportsNetworkCapability() const;
1.552 +
1.553 + /**
1.554 + Sets the uri priority of this controller
1.555 +
1.556 + @param aUriPriority
1.557 + The Uri priority to be assigned.
1.558 +
1.559 + @internalTechnology
1.560 + */
1.561 + IMPORT_C void SetUriPriority(TInt aUriPriority);
1.562 +
1.563 + /**
1.564 + Retrieves the uri priority of this controller.
1.565 + Higher priority implies greater number. ie UriPriority() returning 3
1.566 + has higher prioirty than UriPriority() returning 1.
1.567 +
1.568 + @return The assigned Uri priority.
1.569 +
1.570 + @internalTechnology
1.571 + */
1.572 + IMPORT_C TInt UriPriority() const;
1.573 +
1.574 + /**
1.575 + Check whether the controller plugin supports secure DRM process mode
1.576 +
1.577 + @return A boolean indicating if the plugin supports secure DRM process mode.
1.578 + ETrue for secure DRM process mode supporting controller, EFalse if not.
1.579 +
1.580 + @internalTechnology
1.581 + */
1.582 + IMPORT_C TBool SupportsSecureDRMProcessMode() const;
1.583 +
1.584 + /**
1.585 + Returns the stack space required by this controller.
1.586 +
1.587 + @return The stack space required.
1.588 +
1.589 + @internalTechnology
1.590 + */
1.591 + IMPORT_C TUint StackSize() const;
1.592 +
1.593 +protected:
1.594 +
1.595 + /**
1.596 + Constructor.
1.597 +
1.598 + @internalTechnology
1.599 + */
1.600 + CMMFControllerImplementationInformation();
1.601 +
1.602 + /**
1.603 + 2nd phase constructor.
1.604 +
1.605 + @internalTechnology
1.606 + */
1.607 + void ConstructL(const CImplementationInformation& aImplInfo);
1.608 +
1.609 + /**
1.610 + Parses aData to get the collection UID of the play formats supported by this controller.
1.611 +
1.612 + @internalTechnology
1.613 + */
1.614 + void SetPlayFormatCollectionUidL(const TDesC8& aData);
1.615 +
1.616 + /**
1.617 + Parses aData to get the collection UID of the record formats supported by this controller.
1.618 +
1.619 + @internalTechnology
1.620 + */
1.621 + void SetRecordFormatCollectionUidL(const TDesC8& aData);
1.622 +
1.623 + /**
1.624 + Parses aData to get the size of the stack the controller requires.
1.625 +
1.626 + @internalTechnology
1.627 + */
1.628 + void SetHeapSizeL(const TDesC8& aData);
1.629 +
1.630 + /**
1.631 + From MTaggedDataParserClient.
1.632 + */
1.633 + void ProcessTaggedDataL(const TDesC8& aTag, const TDesC8& aData);
1.634 +
1.635 + /**
1.636 + Queries the ECom registry for:
1.637 + - all registry entries with an interface UID of aFormatCollectionUid
1.638 + - all format plugins with an interface UID of aFormatPluginCollectionUid (ie CMMFFormatEncode
1.639 + or CMMFFormatDecode) that have the UID of this controller plugin in the default_data field
1.640 + of their ECom resource file.
1.641 +
1.642 + CMMFFormatImplementationInformation objects are created for each entry returned, and appended to
1.643 + aFormatArray.
1.644 +
1.645 + @param aFormatCollectionUid
1.646 + See above.
1.647 + @param aFormatPluginCollectionUid
1.648 + See above.
1.649 + @param aFormatArray
1.650 + See above.
1.651 +
1.652 + @internalTechnology
1.653 +
1.654 + @since 7.0s
1.655 + */
1.656 + void GetFormatsL(TUid aFormatCollectionUid, TUid aFormatPluginCollectionUid, RMMFFormatImplInfoArray& aFormatArray);
1.657 +
1.658 + /**
1.659 + Creates CMMFFormatImplementationInformation objects for all CImplementationInformation objects
1.660 + in aEcomArray. Any corrupt objects are ignored. The objects created are added to aFormatArray.
1.661 +
1.662 + @param aEcomArray
1.663 + See above.
1.664 + @param aFormatArray
1.665 + See above.
1.666 +
1.667 + @internalTechnology
1.668 +
1.669 + @since 7.0s
1.670 + */
1.671 + void AddFormatsSwallowCorruptL(RImplInfoPtrArray& aEcomArray, RMMFFormatImplInfoArray& aFormatArray);
1.672 +
1.673 + /**
1.674 + Sets the Uri Scheme found in opaque data
1.675 +
1.676 + @param aUriScheme
1.677 + Gives the uri scheme supported by the controller
1.678 +
1.679 + @internalTechnology
1.680 + */
1.681 + void SetUriSchemeL(const TDesC8& aUriScheme);
1.682 +
1.683 + /**
1.684 + Sets the Network capability found in opaque data
1.685 +
1.686 + @param aNetworkCapable
1.687 + Declares the incapability to support uri if matches to 'yes'.
1.688 + If this is the case, iIsNetworkCtrl is set to EFalse
1.689 +
1.690 + @internalTechnology
1.691 + */
1.692 + void SetNetworkCapabilityL(const TDesC8& aNetworkCapable);
1.693 +
1.694 + /**
1.695 + Parses aData to get the size of the stack the controller requires.
1.696 +
1.697 + @internalTechnology
1.698 + */
1.699 + void SetStackSizeL(const TDesC8& aData);
1.700 +
1.701 +
1.702 +private:
1.703 +
1.704 + /**
1.705 + The play formats supported by this controller.
1.706 + */
1.707 + RMMFFormatImplInfoArray iPlayFormats;
1.708 +
1.709 + /**
1.710 + The record formats supported by this controller.
1.711 + */
1.712 + RMMFFormatImplInfoArray iRecordFormats;
1.713 +
1.714 + /**
1.715 + The interface uid of the resource file definitions of the play formats supported directly by this controller.
1.716 + */
1.717 + TUid iPlayFormatCollectionUid;
1.718 +
1.719 + /**
1.720 + The interface uid of the resource file definitions of the record formats supported directly by this controller.
1.721 + */
1.722 + TUid iRecordFormatCollectionUid;
1.723 +
1.724 + /**
1.725 + The heap space required by this controller
1.726 + */
1.727 + TUint iHeapSpaceRequired;
1.728 +
1.729 + /**
1.730 + The Uri scheme supported by this plugin
1.731 + */
1.732 + CDesC8Array* iUriSchemes;
1.733 +
1.734 + /**
1.735 + The uri priority acquired by this controller
1.736 + */
1.737 + TInt iUriPriority;
1.738 +
1.739 + /**
1.740 + The uri support provided by this controller
1.741 + */
1.742 + TBool iIsNetworkCtrl;
1.743 +
1.744 + /**
1.745 + Secure DRM process model supported by this controller
1.746 + */
1.747 + TBool iSupportsSecureDRMProcessMode;
1.748 + /**
1.749 + The stack space required by this controller
1.750 + */
1.751 + TUint iStackSize;
1.752 + };
1.753 +
1.754 +
1.755 +/**
1.756 +@publishedAll
1.757 +
1.758 +Contains the parameters used to select mmf plugins from the ECOM registry.
1.759 +
1.760 +@released
1.761 +@since 7.0s
1.762 +*/
1.763 +class CMMFPluginSelectionParameters : public CBase
1.764 + {
1.765 +public:
1.766 +
1.767 +/**
1.768 +Describes the type of preferred supplier match to be performed on the plugins return from
1.769 +the ECOM registry.
1.770 +*/
1.771 +enum TPreferredSupplierMatchType
1.772 + {
1.773 +
1.774 + /** No preferred supplier match will be performed.
1.775 + */
1.776 + ENoPreferredSupplierMatch,
1.777 +
1.778 + /** Plugins from all suppliers will be returned, but those from the preferred supplier will be first in the list.
1.779 + */
1.780 + EPreferredSupplierPluginsFirstInList,
1.781 +
1.782 + /** Only plugins from the preferred supplier will be returned.
1.783 + */
1.784 + EOnlyPreferredSupplierPluginsReturned
1.785 + };
1.786 +/**
1.787 +Describes the type of media ID match to be performed on the plugins return from
1.788 +the ECOM registry.
1.789 +*/
1.790 +enum TMediaIdMatchType
1.791 + {
1.792 +
1.793 + /** No media ID match will be performed.
1.794 + */
1.795 + ENoMediaIdMatch,
1.796 +
1.797 + /** All plugins that support the media ID supplied will be returned, even those that support
1.798 + other media IDs. For example, if an audio plugin is requested, plugins that support
1.799 + audio and video will also be returned.
1.800 + */
1.801 + EAllowOtherMediaIds,
1.802 +
1.803 + /** Only plugins that support the exact media IDs supplied will be returned. For example, if an
1.804 + audio plugin is requested, plugins that only support audio will be returned
1.805 + (ie. no audio/video plugins).
1.806 + */
1.807 + EAllowOnlySuppliedMediaIds
1.808 + };
1.809 +
1.810 +public:
1.811 +
1.812 + /**
1.813 + Destructor. Resets and destroys all member data.
1.814 +
1.815 + @since 7.0s
1.816 + */
1.817 + virtual ~CMMFPluginSelectionParameters();
1.818 +
1.819 +
1.820 + /**
1.821 + Sets the preferred supplier of the plugin.
1.822 +
1.823 + @param aPreferredSupplier
1.824 + The preferred supplier of the plugin.
1.825 + @param aMatchType
1.826 + The type of match to be made.
1.827 +
1.828 + @since 7.0s
1.829 + */
1.830 + IMPORT_C void SetPreferredSupplierL(const TDesC& aPreferredSupplier, TPreferredSupplierMatchType aMatchType);
1.831 +
1.832 + /**
1.833 + Sets the media IDs that must be supported by the plugin, for example audio, video etc.
1.834 +
1.835 + @param aMediaIds
1.836 + An array of the media IDs that the selected plugins must support.
1.837 + @param aMatchType
1.838 + The type of match to be made.
1.839 +
1.840 + @since 7.0s
1.841 + */
1.842 + IMPORT_C void SetMediaIdsL(const RArray<TUid>& aMediaIds, TMediaIdMatchType aMatchType);
1.843 +
1.844 + /**
1.845 + Returns the preferred supplier. If no preferred supplier has been set, a blank
1.846 + string will be returned.
1.847 +
1.848 + @return The preferred supplier
1.849 + @since 7.0s
1.850 + */
1.851 + IMPORT_C const TDesC& PreferredSupplier() const;
1.852 +
1.853 + /**
1.854 + Returns the type of preferred supplier match to perform.
1.855 +
1.856 + @return The preferred supplier match type.
1.857 + @since 7.0s
1.858 + */
1.859 + IMPORT_C TPreferredSupplierMatchType PreferredSupplierMatchType() const;
1.860 +
1.861 + /**
1.862 + Returns the list of media IDs that must be supported by the plugin.
1.863 +
1.864 + @return The list of media IDs.
1.865 +
1.866 + @since 7.0s
1.867 + */
1.868 + IMPORT_C const RArray<TUid>& MediaIds() const;
1.869 +
1.870 + /**
1.871 + Returns the type of preferred supplier match to perform.
1.872 +
1.873 + @return The preferred supplier match type.
1.874 +
1.875 + @since 7.0s
1.876 + */
1.877 + IMPORT_C TMediaIdMatchType MediaIdMatchType() const;
1.878 +
1.879 + /**
1.880 + Returns the uid of the interface to be searched for plugin matches.
1.881 +
1.882 + @return The interface uid.
1.883 +
1.884 + @since 7.0s
1.885 + */
1.886 + IMPORT_C TUid InterfaceUid() const;
1.887 +
1.888 +protected:
1.889 +
1.890 + /**
1.891 + Protected constructor.
1.892 +
1.893 + Defaults to setting the TPreferredSupplierMatchType enum to ENoPreferredSupplierMatch and TMediaIdMatchType
1.894 + to ENoMediaIdMatch.
1.895 +
1.896 + @param aPluginInterfaceUid
1.897 + The plugin's interface UID.
1.898 + */
1.899 + CMMFPluginSelectionParameters(TUid aPluginInterfaceUid);
1.900 +
1.901 + /**
1.902 + Tests whether the specified media is supported by the plugin.
1.903 +
1.904 + @param aPlugin
1.905 + The media to test.
1.906 +
1.907 + @return A boolean indicating if the specified media is supported by the plugin. ETrue if the specified
1.908 + media is supported by the plugin. EFalse if the specified media is not supported by the plugin.
1.909 + */
1.910 + TBool CheckMediaIdSupportL(const CMMFPluginImplementationInformation& aPlugin) const;
1.911 +private:
1.912 + TUid iPluginInterfaceUid;
1.913 + HBufC* iPreferredSupplier;
1.914 + TPreferredSupplierMatchType iPreferredSupplierMatchType;
1.915 + RArray<TUid> iMediaIds;
1.916 + TMediaIdMatchType iMediaIdMatchType;
1.917 + };
1.918 +
1.919 +/**
1.920 +@publishedAll
1.921 +
1.922 +Defines the format support required.
1.923 +
1.924 +On construction, the selection parameters are blank, causing all plugins to be returned.
1.925 +
1.926 +@released
1.927 +@since 7.0s
1.928 +*/
1.929 +class CMMFFormatSelectionParameters : public CBase
1.930 + {
1.931 +public:
1.932 +/**
1.933 +Describes the type of match to be performed.
1.934 +The match types are mutually exclusive.
1.935 +*/
1.936 +enum TMatchDataType
1.937 + {
1.938 +
1.939 + /** All plugins will be selected. This is the default option.
1.940 + */
1.941 + EMatchAny,
1.942 +
1.943 + /** The match will be based on a file extension.
1.944 + */
1.945 + EMatchFileExtension,
1.946 +
1.947 + /** The match will be based on a mime type.
1.948 + */
1.949 + EMatchMimeType,
1.950 +
1.951 + /** The match will be based on a header data.
1.952 + */
1.953 + EMatchHeaderData,
1.954 +
1.955 + /**
1.956 + @publishedPartner
1.957 + @released
1.958 +
1.959 + The match will be based on Uri details.
1.960 + */
1.961 + EMatchUri
1.962 + };
1.963 +
1.964 +public:
1.965 +
1.966 + /**
1.967 + Allocates and constructs a new format selection parameter object with blank parameters.
1.968 +
1.969 + Calls NewLC().
1.970 +
1.971 + @return A new format selection parameter object.
1.972 + */
1.973 + IMPORT_C static CMMFFormatSelectionParameters* NewL();
1.974 +
1.975 + /**
1.976 + Allocates and constructs a new format selection parameter object with blank parameters, placing it on the
1.977 + cleanup stack.
1.978 +
1.979 + @return A new format selection parameter object.
1.980 + */
1.981 + IMPORT_C static CMMFFormatSelectionParameters* NewLC();
1.982 +
1.983 + /**
1.984 + Allocates and constructs a new format selection parameter object with the specified parameters.
1.985 +
1.986 + @param aParams
1.987 + The required parameters.
1.988 + @return A new format selection parameter object.
1.989 + */
1.990 + static CMMFFormatSelectionParameters* NewL(const CMMFFormatSelectionParameters& aParams);
1.991 +
1.992 + /**
1.993 + Sets this object to match to a file extension.
1.994 +
1.995 + aFileName can be a full filename or just an extension. If there is no dot in the filename
1.996 + and it is 5 characters or less in length then it is assumed to be an extension. If the first
1.997 + character of the filename is a dot, it assumed to be an extension. Otherwise, the filename
1.998 + is parsed using TParse to reveal the extension.
1.999 +
1.1000 + Once the extension has been extracted, it is converted from unicode to utf8 and copied into
1.1001 + iMatchData.
1.1002 +
1.1003 + @param aFileName
1.1004 + The file name to be matched. Must include the extension.
1.1005 +
1.1006 + @since 7.0s
1.1007 + */
1.1008 + IMPORT_C void SetMatchToFileNameL(const TDesC& aFileName);
1.1009 +
1.1010 + /**
1.1011 + Sets this object to match to a file extension specified by a URI
1.1012 +
1.1013 + Once the extension has been extracted, it is copied into iMatchData.
1.1014 +
1.1015 + @param aUri
1.1016 + The URI containing the file name to be matched. Must include the extension.
1.1017 +
1.1018 + @since 7.0s
1.1019 + */
1.1020 + IMPORT_C void SetMatchToUriL(const TDesC& aUri);
1.1021 +
1.1022 + /**
1.1023 + @publishedPartner
1.1024 + @released
1.1025 +
1.1026 + Sets this object to match to uri scheme and file extension specified by a URI.
1.1027 +
1.1028 + The Uri scheme and extension are saved in iMatchReqData. Further,iMatchData contains uri extension,
1.1029 + iMatchUriScheme contains uri scheme.
1.1030 +
1.1031 + @param aUri
1.1032 + The URI containing the scheme and uri extension to be matched.
1.1033 +
1.1034 + */
1.1035 + IMPORT_C void SetMatchToUriSupportL(const TDesC& aUri);
1.1036 +
1.1037 + /**
1.1038 + Sets this object to match to a MIME type.
1.1039 +
1.1040 + @param aMimeType
1.1041 + The mime type to match.
1.1042 +
1.1043 + @since 7.0s
1.1044 + */
1.1045 + IMPORT_C void SetMatchToMimeTypeL(const TDesC8& aMimeType);
1.1046 +
1.1047 + /**
1.1048 + Sets this object to match to a pattern in header data.
1.1049 +
1.1050 + @param aHeaderData
1.1051 + The header of the file in question. This header data will be matched
1.1052 + against the match patterns provided by the plugins.
1.1053 +
1.1054 + @since 7.0s
1.1055 + */
1.1056 + IMPORT_C void SetMatchToHeaderDataL(const TDesC8& aHeaderData);
1.1057 +
1.1058 + /**
1.1059 + Returns the data used to perform the plugin match.
1.1060 +
1.1061 + @return The match data.
1.1062 +
1.1063 + @since 7.0s
1.1064 + */
1.1065 + IMPORT_C const TDesC8& MatchData() const;
1.1066 +
1.1067 + /**
1.1068 + @publishedPartner
1.1069 + @released
1.1070 +
1.1071 + Returns the uri scheme used to perform the plugin match.
1.1072 +
1.1073 + @return The uri scheme.
1.1074 +
1.1075 + */
1.1076 + IMPORT_C const TDesC8& MatchUriScheme() const;
1.1077 +
1.1078 + /**
1.1079 + Returns the type of the data used to perform the plugin match.
1.1080 +
1.1081 + @return The match data type.
1.1082 +
1.1083 + @since 7.0s
1.1084 + */
1.1085 + IMPORT_C TMatchDataType MatchDataType() const;
1.1086 +
1.1087 + /**
1.1088 + Destructor.
1.1089 + */
1.1090 + virtual ~CMMFFormatSelectionParameters();
1.1091 +protected:
1.1092 +
1.1093 + /**
1.1094 + Protected constructor.
1.1095 + */
1.1096 + CMMFFormatSelectionParameters();
1.1097 + void ConstructL(const CMMFFormatSelectionParameters& aParams);
1.1098 +
1.1099 +private:
1.1100 + CMatchData* iMatchReqData;
1.1101 + TMatchDataType iMatchDataType;
1.1102 + };
1.1103 +
1.1104 +
1.1105 +
1.1106 +/**
1.1107 +@publishedAll
1.1108 +@released
1.1109 +
1.1110 +Contains the parameters used to select controller plugins from the ECOM registry.
1.1111 +
1.1112 +@since 7.0s
1.1113 +*/
1.1114 +class CMMFControllerPluginSelectionParameters : public CMMFPluginSelectionParameters
1.1115 + {
1.1116 +public:
1.1117 +
1.1118 + /**
1.1119 + Constructs a new controller selection parameters object.
1.1120 +
1.1121 + @return The new object created.
1.1122 +
1.1123 + @since 7.0s
1.1124 + */
1.1125 + IMPORT_C static CMMFControllerPluginSelectionParameters* NewL();
1.1126 +
1.1127 + /**
1.1128 + Construct a new controller selection parameters object.
1.1129 +
1.1130 + @return The new object created. Note that the new object will be left on the cleanup stack.
1.1131 +
1.1132 + @since 7.0s
1.1133 + */
1.1134 + IMPORT_C static CMMFControllerPluginSelectionParameters* NewLC();
1.1135 +
1.1136 + /**
1.1137 + Sets the play format support required.
1.1138 +
1.1139 + Note:
1.1140 + The play formats supported by the controller plugins will only be retrieved if
1.1141 + this method is called. To get all the play formats supported by the system, call this
1.1142 + with a 'blank' CMMFFormatSelectionParameters object.
1.1143 +
1.1144 + @param aRequiredSupport
1.1145 + The play format support required.
1.1146 +
1.1147 + @since 7.0s
1.1148 + */
1.1149 + IMPORT_C void SetRequiredPlayFormatSupportL(const CMMFFormatSelectionParameters& aRequiredSupport);
1.1150 +
1.1151 + /**
1.1152 + Sets the record format support required.
1.1153 +
1.1154 + Note:
1.1155 + The record formats supported by the controller plugins will only be retrieved if
1.1156 + this method is called. To get all the record formats supported by the system, call this
1.1157 + with a 'blank' CMMFFormatSelectionParameters object.
1.1158 +
1.1159 + @param aRequiredSupport
1.1160 + The record format support required.
1.1161 +
1.1162 + @return The new object created.
1.1163 +
1.1164 + @since 7.0s
1.1165 + */
1.1166 + IMPORT_C void SetRequiredRecordFormatSupportL(const CMMFFormatSelectionParameters& aRequiredSupport);
1.1167 +
1.1168 + /**
1.1169 + Retrieves all controller plugins that support the requirements of the caller.
1.1170 +
1.1171 + @param aImplementations
1.1172 + After this method returns, this array will contain all the
1.1173 + controller plugins that support the caller's requirements.
1.1174 + Note: The array will be emptied by this method.
1.1175 +
1.1176 + @since 7.0s
1.1177 + */
1.1178 + IMPORT_C virtual void ListImplementationsL(RMMFControllerImplInfoArray& aImplementations) const;
1.1179 +
1.1180 + /**
1.1181 + Destructor
1.1182 + */
1.1183 + virtual ~CMMFControllerPluginSelectionParameters();
1.1184 +protected:
1.1185 + CMMFControllerPluginSelectionParameters();
1.1186 + void MatchImplementationToSelectParamsL(RMMFControllerImplInfoArray& aImplementations, const CMMFControllerImplementationInformation& aPlugin, TInt& aArrayPos) const;
1.1187 + TInt CheckPreferredSupplierL(RMMFControllerImplInfoArray& aImplementations, const CMMFControllerImplementationInformation& aPlugin) const;
1.1188 + TBool CheckFormatSupportL(CMMFFormatSelectionParameters* aSelectParams, const RMMFFormatImplInfoArray& aFormats) const;
1.1189 + /**
1.1190 + Checks the given Controller for uri support. Uri support may be there
1.1191 + if either requiredscheme or extension matches with that given controller
1.1192 +
1.1193 + @param aSelectParams
1.1194 + Describes the selection parameter which a controller needs to
1.1195 + support in order to be selected
1.1196 +
1.1197 + @param aPlugin
1.1198 + The controller plugin which is checked for uri support
1.1199 +
1.1200 + @param aFormats
1.1201 + The play or record formats looked for extension match
1.1202 + */
1.1203 + TBool CheckUriSupport(CMMFFormatSelectionParameters* aSelectParams, CMMFControllerImplementationInformation* aPlugin, const RMMFFormatImplInfoArray& aFormats) const;
1.1204 +
1.1205 +protected:
1.1206 + /**
1.1207 + The required play format support
1.1208 + */
1.1209 + CMMFFormatSelectionParameters* iRequiredPlayFormatSupport;
1.1210 +
1.1211 + /**
1.1212 + The required record format support
1.1213 + */
1.1214 + CMMFFormatSelectionParameters* iRequiredRecordFormatSupport;
1.1215 + };
1.1216 +
1.1217 +/**
1.1218 +@publishedAll
1.1219 +@released
1.1220 +
1.1221 +Contains the parameters used to select controller plugins which support SecureDRM model
1.1222 +from the ECOM registry. Controller plugins which support SecureDRM model allow play back of DRM-protected
1.1223 +content by client processes without DRM capability. In such case the controller will be loaded in a separate secure DRM process.
1.1224 +*/
1.1225 +class CMMFControllerSecureDrmPluginSelectionParameters : public CMMFControllerPluginSelectionParameters
1.1226 + {
1.1227 +
1.1228 +public:
1.1229 + /**
1.1230 + Constructs a new controller selection parameters object.
1.1231 +
1.1232 + @return The new object created.
1.1233 + */
1.1234 + IMPORT_C static CMMFControllerSecureDrmPluginSelectionParameters* NewL();
1.1235 +
1.1236 + /**
1.1237 + Construct a new controller selection parameters object.
1.1238 +
1.1239 + @return The new object created. Note that the new object will be left on the cleanup stack.
1.1240 + */
1.1241 + IMPORT_C static CMMFControllerSecureDrmPluginSelectionParameters* NewLC();
1.1242 +
1.1243 + /**
1.1244 + Retrieves all controller plugins that support SecureDRM model and the requirements of the caller.
1.1245 +
1.1246 + @param aImplementations
1.1247 + After this method returns, this array will contain all the
1.1248 + controller plugins that support the caller's requirements.
1.1249 + Note: The array will be emptied by this method and SecureDRM model.
1.1250 + */
1.1251 + IMPORT_C virtual void ListImplementationsL(RMMFControllerImplInfoArray& aImplementations) const;
1.1252 +
1.1253 + /**
1.1254 + Destructor
1.1255 + */
1.1256 + virtual ~CMMFControllerSecureDrmPluginSelectionParameters() {};
1.1257 +protected:
1.1258 + CMMFControllerSecureDrmPluginSelectionParameters();
1.1259 + };
1.1260 +
1.1261 +/**
1.1262 +@publishedAll
1.1263 +@released
1.1264 +
1.1265 +Abstract class used to contain the parameters used to select format plugins from the ECOM registry.
1.1266 +
1.1267 +Note:
1.1268 +The classes CMMFFormatEncodePluginSelectionParamters and CMMFFormatDecodePluginSelectionParameters
1.1269 +should be used to list and select format plugin implementations.
1.1270 +
1.1271 +@since 7.0s
1.1272 +*/
1.1273 +class CMMFFormatPluginSelectionParameters : public CMMFPluginSelectionParameters
1.1274 + {
1.1275 +public:
1.1276 +
1.1277 + /**
1.1278 + Retrieves all format plugins that support the requirements of the caller.
1.1279 +
1.1280 + @param aImplementations
1.1281 + After this function returns, this array will contain all the
1.1282 + format plugins that support the caller's requirements.
1.1283 + Note: The array will be emptied by this method.
1.1284 +
1.1285 + @since 7.0s
1.1286 + */
1.1287 + IMPORT_C void ListImplementationsL(RMMFFormatImplInfoArray& aImplementations) const;
1.1288 +
1.1289 + /**
1.1290 + Sets the format support required.
1.1291 +
1.1292 + @param aRequiredSupport
1.1293 + The format support required.
1.1294 +
1.1295 + @since 7.0s
1.1296 + */
1.1297 + IMPORT_C void SetRequiredFormatSupportL(const CMMFFormatSelectionParameters& aRequiredSupport);
1.1298 +
1.1299 + /**
1.1300 + Destructor.
1.1301 + */
1.1302 + virtual ~CMMFFormatPluginSelectionParameters();
1.1303 +protected:
1.1304 + /**
1.1305 + Protected constructor.
1.1306 + */
1.1307 + CMMFFormatPluginSelectionParameters(TUid aInterfaceUid);
1.1308 +
1.1309 + void MatchImplementationToSelectParamsL(RMMFFormatImplInfoArray& aImplementations, const CMMFFormatImplementationInformation& aPlugin, TInt& aArrayPos) const;
1.1310 + TInt CheckPreferredSupplierL(RMMFFormatImplInfoArray& aImplementations, const CMMFFormatImplementationInformation& aPlugin) const;
1.1311 + TBool CheckFormatSupportL(const CMMFFormatImplementationInformation& aPlugin) const;
1.1312 +protected:
1.1313 + /**
1.1314 + The format support required
1.1315 + */
1.1316 + CMMFFormatSelectionParameters* iRequiredFormatSupport;
1.1317 + };
1.1318 +
1.1319 +/**
1.1320 +@publishedAll
1.1321 +@released
1.1322 +
1.1323 +Class used to list and select plugins implementing the CMMFFormatEncode interface.
1.1324 +
1.1325 +@since 7.0s
1.1326 +*/
1.1327 +class CMMFFormatEncodePluginSelectionParameters : public CMMFFormatPluginSelectionParameters
1.1328 + {
1.1329 +public:
1.1330 +
1.1331 + /**
1.1332 + Construct a new format encode selection parameters object.
1.1333 +
1.1334 + @return The new object created.
1.1335 +
1.1336 + @since 7.0s
1.1337 + */
1.1338 + IMPORT_C static CMMFFormatEncodePluginSelectionParameters* NewL();
1.1339 +
1.1340 + /**
1.1341 + Constructs a new format encode selection parameters object.
1.1342 +
1.1343 + @return The new object created. Note that the new object will be left on the cleanup stack.
1.1344 +
1.1345 + @since 7.0s
1.1346 + */
1.1347 + IMPORT_C static CMMFFormatEncodePluginSelectionParameters* NewLC();
1.1348 +protected:
1.1349 + /**
1.1350 + Protected constructor.
1.1351 + */
1.1352 + CMMFFormatEncodePluginSelectionParameters();
1.1353 + };
1.1354 +
1.1355 +
1.1356 +/**
1.1357 +@publishedAll
1.1358 +@released
1.1359 +
1.1360 +Class used to list and select plugins implementing the CMMFFormatDecode interface.
1.1361 +
1.1362 +@since 7.0s
1.1363 +*/
1.1364 +class CMMFFormatDecodePluginSelectionParameters : public CMMFFormatPluginSelectionParameters
1.1365 + {
1.1366 +public:
1.1367 +
1.1368 + /**
1.1369 + Constructs a new format decode selection parameters object.
1.1370 +
1.1371 + @return The new object created.
1.1372 +
1.1373 + @since 7.0s
1.1374 + */
1.1375 + IMPORT_C static CMMFFormatDecodePluginSelectionParameters* NewL();
1.1376 +
1.1377 + /**
1.1378 + Constructs a new format decode selection parameters object.
1.1379 +
1.1380 + @return The new object created. Note that the new object will be left on the cleanup stack.
1.1381 +
1.1382 + @since 7.0s
1.1383 + */
1.1384 + IMPORT_C static CMMFFormatDecodePluginSelectionParameters* NewLC();
1.1385 +protected:
1.1386 + /**
1.1387 + Protected constructor.
1.1388 + */
1.1389 + CMMFFormatDecodePluginSelectionParameters();
1.1390 + };
1.1391 +
1.1392 +
1.1393 +
1.1394 +/**
1.1395 +@publishedAll
1.1396 +@released
1.1397 +
1.1398 +Template class CleanupResetAndDestroy to clean up the array
1.1399 +of implementation information from the cleanup stack.
1.1400 +*/
1.1401 +
1.1402 +template <class T>
1.1403 +class CleanupResetAndDestroy
1.1404 + {
1.1405 +public:
1.1406 + /**
1.1407 + Puts an item on the cleanup stack.
1.1408 +
1.1409 + @param aRef
1.1410 + The implementation information to be put on the cleanup stack.
1.1411 + */
1.1412 + inline static void PushL(T& aRef);
1.1413 +private:
1.1414 + static void ResetAndDestroy(TAny *aPtr);
1.1415 + };
1.1416 +template <class T>
1.1417 +inline void CleanupResetAndDestroyPushL(T& aRef);
1.1418 +template <class T>
1.1419 +inline void CleanupResetAndDestroy<T>::PushL(T& aRef)
1.1420 + {CleanupStack::PushL(TCleanupItem(&ResetAndDestroy,&aRef));}
1.1421 +template <class T>
1.1422 +void CleanupResetAndDestroy<T>::ResetAndDestroy(TAny *aPtr)
1.1423 + {(STATIC_CAST(T*,aPtr))->ResetAndDestroy();}
1.1424 +template <class T>
1.1425 +inline void CleanupResetAndDestroyPushL(T& aRef)
1.1426 + {CleanupResetAndDestroy<T>::PushL(aRef);}
1.1427 +
1.1428 +
1.1429 +#endif