RMMFControllerProxy Class Reference
class RMMFControllerProxy : public RMmfSessionBase |
RSessionBase-based client class to handle the creation of the controller thread and message sending over IPC.
The controller proxy is responsible for sending and recieving messages over IPC; it does not care exactly what those messages are.
Note the fact that, although this is an internal component, its size cannot be changed because it's embedded in a publishedAll class (RMMFController) and the size of the latter would also be changed raising a binary compatibility problem.
Public Member Functions |
---|
| RMMFControllerProxy() |
IMPORT_C TInt | CancelReceiveEvents() |
IMPORT_C void | Close() |
IMPORT_C TInt | LoadController(TUid, TBool) |
IMPORT_C TInt | LoadController(const CMMFControllerImplementationInformation &, TBool) |
IMPORT_C TInt | LoadControllerInSecureDRMProcess(TUid, TBool) |
IMPORT_C TInt | LoadControllerInSecureDRMProcess(const CMMFControllerImplementationInformation &, TBool) |
IMPORT_C void | ReceiveEvents(TMMFEventPckg &, TRequestStatus &) |
IMPORT_C void | SendAsync(const TMMFMessageDestinationPckg &, TInt, const TDesC8 &, const TDesC8 &, TDes8 &, TRequestStatus &) |
IMPORT_C void | SendAsync(const TMMFMessageDestinationPckg &, TInt, const TDesC8 &, const TDesC8 &, TRequestStatus &) |
IMPORT_C void | SendAsync(TInt, const TIpcArgs &, TRequestStatus &) |
IMPORT_C TInt | SendSync(const TMMFMessageDestinationPckg &, TInt, const TDesC8 &, const TDesC8 &, TDes8 &) |
IMPORT_C TInt | SendSync(const TMMFMessageDestinationPckg &, TInt, const TDesC8 &, const TDesC8 &) |
IMPORT_C TInt | SendSync(TInt, const TIpcArgs &) |
IMPORT_C TInt | SetThreadPriority(const TThreadPriority &) |
void | ThreadTerminated() |
Inherited Functions |
---|
| RHandleBase::Attributes()const |
| RHandleBase::BTraceId()const |
| RHandleBase::DoExtendedClose() |
| RHandleBase::Duplicate(const RThread &,TOwnerType) |
| RHandleBase::FullName()const |
| RHandleBase::FullName(TDes &)const |
| RHandleBase::Handle()const |
| RHandleBase::HandleInfo(THandleInfo *) |
| RHandleBase::Name()const |
| RHandleBase::NotifyDestruction(TRequestStatus &) |
| RHandleBase::Open(const TFindHandleBase &,TOwnerType) |
| RHandleBase::OpenByName(const TDesC &,TOwnerType,TInt) |
| RHandleBase::RHandleBase() |
| RHandleBase::RHandleBase(TInt) |
| RHandleBase::SetHandle(TInt) |
| RHandleBase::SetHandleNC(TInt) |
| RMmfSessionBase::SendReceive(TInt)const |
| RMmfSessionBase::SendReceive(TInt,TInt)const |
| RMmfSessionBase::SendReceive(TInt,TInt,TInt)const |
| RMmfSessionBase::SendReceive(TInt,TInt,TInt,TRequestStatus &)const |
| RMmfSessionBase::SendReceive(TInt,TInt,TRequestStatus &)const |
| RMmfSessionBase::SendReceive(TInt,TInt,const TDesC8 &,const TDesC8 &)const |
| RMmfSessionBase::SendReceive(TInt,TInt,const TDesC8 &,const TDesC8 &,TRequestStatus &)const |
| RMmfSessionBase::SendReceive(TInt,TRequestStatus &)const |
| RMmfSessionBase::SendReceive(TInt,const TDesC &)const |
| RMmfSessionBase::SendReceive(TInt,const TDesC &,TRequestStatus &)const |
| RMmfSessionBase::SendReceive(TInt,const TDesC8 &)const |
| RMmfSessionBase::SendReceive(TInt,const TDesC8 &,TRequestStatus &)const |
| RMmfSessionBase::SendReceive(TInt,const TDesC8 &,const TDesC8 &)const |
| RMmfSessionBase::SendReceive(TInt,const TDesC8 &,const TDesC8 &,TRequestStatus &)const |
| RMmfSessionBase::SendReceive(TInt,const TDesC8 &,const TDesC8 &,const TDesC8 &)const |
| RMmfSessionBase::SendReceive(TInt,const TDesC8 &,const TDesC8 &,const TDesC8 &,TRequestStatus &)const |
| RMmfSessionBase::SendReceiveResult(TInt,TDes8 &)const |
| RMmfSessionBase::SendReceiveResult(TInt,TDes8 &,TRequestStatus &)const |
| RMmfSessionBase::SendReceiveResult(TInt,TInt,const TDesC8 &,const TDesC8 &,TDes8 &)const |
| RMmfSessionBase::SendReceiveResult(TInt,TInt,const TDesC8 &,const TDesC8 &,TDes8 &,TRequestStatus &)const |
| RMmfSessionBase::SendReceiveResult(TInt,const TDesC8 &,const TDesC8 &,TDes &)const |
| RMmfSessionBase::SendReceiveResult(TInt,const TDesC8 &,const TDesC8 &,TDes8 &)const |
| RMmfSessionBase::SendReceiveResult(TInt,const TDesC8 &,const TDesC8 &,TDes8 &,TRequestStatus &)const |
| RMmfSessionBase::SendReceiveResult(TInt,const TDesC8 &,const TDesC8 &,const TDesC8 &,TDes8 &)const |
| RMmfSessionBase::SendReceiveResult(TInt,const TDesC8 &,const TDesC8 &,const TDesC8 &,TDes8 &,TRequestStatus &)const |
| RSessionBase::CreateSession(RServer2,const TVersion &) |
| RSessionBase::CreateSession(RServer2,const TVersion &,TInt) |
| RSessionBase::CreateSession(RServer2,const TVersion &,TInt,TIpcSessionType,const TSecurityPolicy *,TRequestStatus *) |
| RSessionBase::CreateSession(const TDesC &,const TVersion &) |
| RSessionBase::CreateSession(const TDesC &,const TVersion &,TInt) |
| RSessionBase::CreateSession(const TDesC &,const TVersion &,TInt,TIpcSessionType,const TSecurityPolicy *,TRequestStatus *) |
| RSessionBase::CreateSession(const TDesC &,const TVersion &,TInt,TRequestStatus *) |
| RSessionBase::Open(RMessagePtr2,TInt,TOwnerType) |
| RSessionBase::Open(RMessagePtr2,TInt,const TSecurityPolicy &,TOwnerType) |
| RSessionBase::Open(TInt,TOwnerType) |
| RSessionBase::Open(TInt,const TSecurityPolicy &,TOwnerType) |
| RSessionBase::Send(TInt)const |
| RSessionBase::Send(TInt,const TIpcArgs &)const |
| RSessionBase::SendReceive(TInt,const TIpcArgs &)const |
| RSessionBase::SendReceive(TInt,const TIpcArgs &,TRequestStatus &)const |
| RSessionBase::SetReturnedHandle(TInt) |
| RSessionBase::SetReturnedHandle(TInt,RHandleBase &) |
| RSessionBase::SetReturnedHandle(TInt,const TSecurityPolicy &) |
| RSessionBase::ShareAuto() |
| RSessionBase::ShareProtected() |
Constructor & Destructor Documentation
RMMFControllerProxy()
IMPORT_C | RMMFControllerProxy | ( | ) | |
Member Functions Documentation
CancelReceiveEvents()
IMPORT_C TInt | CancelReceiveEvents | ( | ) | |
Cancel a previous registration to receive events from the controller framework.
This must be called from the DoCancel() method of the active object using the ReceiveEvents() API.
Close()
Delete the controller plugin and close its thread.
Clients must call Close() on the controller proxy, otherwise leaks will occur.
ControllersMaxHeapSizeL(TUid)
TUint
| ControllersMaxHeapSizeL | ( | TUid | aControllerUid | ) | [private] |
Determines the maximum heap size required by the selected controller
DoCreateSessionForNoDRMCapClient(TUint, TBool, TUint)
TInt
| DoCreateSessionForNoDRMCapClient | ( | TUint | aMaxHeapSize, |
| TBool | aUseSharedHeap, |
| TUint | aStackSize |
| ) | [private] |
Create a session to handle situation of playing DRM protected content in process with no DRM capability. DRM server process will be created, if not yet created. This server is responsible to manage and monitor all the MMF Controller servers created as seperate threads belong to DRM server process. Once the new MMF Controller server is running, a MMF Controller server session will be created and the handle is passing back.
DoCreateSubThread(RServer2 *, TUint, TBool, TUint)
LoadController(TUid, TBool)
IMPORT_C TInt | LoadController | ( | TUid | aControllerUid, |
| TBool | aUseSharedHeap |
| ) | |
Create a new thread and load a controller plugin into that thread.
Parameters
TUid aControllerUid | The UID of the controller plugin to be loaded. |
TBool aUseSharedHeap | If this value is EFalse each controller is created with its own heap. The alternative, if the value is ETrue, is that controllers share a special heap with other controllers created the same way. Each heap uses a chunk, so this avoids situations where the number of chunks per process is limited. The default behaviour is generally to be preferred, and should give lower overall memory usage. However, if many controllers are to be created for a particular thread, then ETrue should be provided to prevent running out of heaps or chunks. |
LoadController(const CMMFControllerImplementationInformation &, TBool)
Create a new thread and load a controller plugin into that thread.
Parameters
const CMMFControllerImplementationInformation & aControllerInfo | A reference to a CMMFControllerImplementationInformation object used for determining the controller UID and heap size |
TBool aUseSharedHeap | If this value is EFalse each controller is created with its own heap. The alternative, if the value is ETrue, is that controllers share a special heap with other controllers created the same way. Each heap uses a chunk, so this avoids situations where the number of chunks per process is limited. The default behaviour is generally to be preferred, and should give lower overall memory usage. However, if many controllers are to be created for a particular thread, then ETrue should be provided to prevent running out of heaps or chunks. |
LoadController(TUid, const CMMFControllerImplementationInformation &, TBool, TBool)
Parameters
TUid aControllerUid | The UID of the controller plugin to be loaded. |
const CMMFControllerImplementationInformation & aControllerInfo | A reference to a CMMFControllerImplementationInformation object used for determining the heap size and DRM server supporting state. |
TBool aUseSharedHeap | If this value is EFalse each controller is created with its own heap. The alternative, if the value is ETrue, is that controllers share a special heap with other controllers created the same way. Each heap uses a chunk, so this avoids situations where the number of chunks per process is limited. The default behaviour is generally to be preferred, and should give lower overall memory usage. However, if many controllers are to be created for a particular thread, then ETrue should be provided to prevent running out of heaps or chunks. |
TBool aNoDRMCap = EFalse | The indicator supplied from user used to determine whether the user's process has DRM capability |
LoadControllerInSecureDRMProcess(TUid, TBool)
IMPORT_C TInt | LoadControllerInSecureDRMProcess | ( | TUid | aControllerUid, |
| TBool | aUseSharedHeap |
| ) | |
Create a new thread in another process through Secure DRM Plugin server and load a controller plugin into that thread. The motivation of this model is to allow applications without DRM capability able to play protected content through MMF.
Parameters
TUid aControllerUid | The UID of the controller plugin to be loaded. |
TBool aUseSharedHeap | If this value is EFalse each controller is created with its own heap. The alternative, if the value is ETrue, is that controllers share a special heap with other controllers created the same way. Each heap uses a chunk, so this avoids situations where the number of chunks per process is limited. The default behaviour is generally to be preferred, and should give lower overall memory usage. However, if many controllers are to be created for a particular thread, then ETrue should be provided to prevent running out of heaps or chunks. |
LoadControllerInSecureDRMProcess(const CMMFControllerImplementationInformation &, TBool)
Create a new thread in another process through Secure DRM Plugin server and load a controller plugin into that thread. The motivation of this model is to allow applications without DRM capability able to play protected content through MMF.
Parameters
const CMMFControllerImplementationInformation & aControllerInfo | A reference to a CMMFControllerImplementationInformation object used for determining the controller UID and heap size |
TBool aUseSharedHeap | If this value is EFalse each controller is created with its own heap. The alternative, if the value is ETrue, is that controllers share a special heap with other controllers created the same way. Each heap uses a chunk, so this avoids situations where the number of chunks per process is limited. The default behaviour is generally to be preferred, and should give lower overall memory usage. However, if many controllers are to be created for a particular thread, then ETrue should be provided to prevent running out of heaps or chunks. |
ReceiveEvents(TMMFEventPckg &, TRequestStatus &)
Register to receive events from the controller framework.
Events can be generated at any time, and are generally associated with things that occur due to something happening internally within the controller. For example, an event will be generated if the controller stops playing due to reaching the end of a file.
Parameters
TMMFEventPckg & aEvent | A reference to a TMMFEventPckg object that must be member data of the active object calling this method. The details of the event will be copied into this object when an event occurs. |
TRequestStatus & aStatus | The TRequestStatus of the active object calling this method. |
ReleaseHeap()
void | ReleaseHeap | ( | ) | [private] |
Release heap - for use when a shared heap has been registered
SendAsync(const TMMFMessageDestinationPckg &, TInt, const TDesC8 &, const TDesC8 &, TDes8 &, TRequestStatus &)
Send a message asynchronously to the controller thread.
The controller framework will analyze the message to determine its correct destination.
Note: This method will return immediately. The RunL of the active object owning the aStatus parameter will be called when the command is completed by the controller framework.
Parameters
const TMMFMessageDestinationPckg & aDestination | The destination of the message, consisting of the uid of the interface of this message. |
TInt aFunction | The function number to indicate which function is to be called on the interface defined in the aDestination parameter. |
const TDesC8 & aDataTo1 | A reference to the first chunk of data to be copied to the controller framework. The exact contents of the data are dependent on the interface being called. Can be NULL. |
const TDesC8 & aDataTo2 | A reference to the second chunk of data to be copied to the controller framework. The exact contents of the data are dependent on the interface being called. Can be NULL. |
TDes8 & aDataFrom | A reference to an area of memory to which the controller framework will write any data to be passed back to the client. Can't be NULL. |
TRequestStatus & aStatus | The TRequestStatus of an active object. This will contain the result of the request on completion. The exact range of result values is dependent on the interface. |
SendAsync(const TMMFMessageDestinationPckg &, TInt, const TDesC8 &, const TDesC8 &, TRequestStatus &)
Send a message asynchronously to the controller thread.
The controller framework will analyze the message to determine its correct destination.
Note: This method will return immediately. The RunL of the active object owning the aStatus parameter will be called when the command is completed by the controller framework.
Parameters
const TMMFMessageDestinationPckg & aDestination | The destination of the message, consisting of the uid of the interface of this message. |
TInt aFunction | The function number to indicate which function is to be called on the interface defined in the aDestination parameter. |
const TDesC8 & aDataTo1 | A reference to the first chunk of data to be copied to the controller framework. The exact contents of the data are dependent on the interface being called. Can be NULL. |
const TDesC8 & aDataTo2 | A reference to the second chunk of data to be copied to the controller framework. The exact contents of the data are dependent on the interface being called. Can be NULL. |
TRequestStatus & aStatus | The TRequestStatus of an active object. This will contain the result of the request on completion. The exact range of result values is dependent on the interface. |
SendAsync(TInt, const TIpcArgs &, TRequestStatus &)
SendSync(const TMMFMessageDestinationPckg &, TInt, const TDesC8 &, const TDesC8 &, TDes8 &)
Send a message synchronously to the controller thread.
The controller framework will analyze the message to determine its correct destination.
Note: This method will not return until the controller framework has serviced the command.
Parameters
const TMMFMessageDestinationPckg & aDestination | The destination of the message, consisting of the uid of the interface of this message. |
TInt aFunction | The function number to indicate which function is to be called on the interface defined in the aDestination parameter. |
const TDesC8 & aDataTo1 | A reference to the first chunk of data to be copied to the controller framework. The exact contents of the data are dependent on the interface being called. Can be NULL. |
const TDesC8 & aDataTo2 | A reference to the second chunk of data to be copied to the controller framework. The exact contents of the data are dependent on the interface being called. Can be NULL. |
TDes8 & aDataFrom | A reference to an area of memory to which the controller framework will write any data to be passed back to the client. Can't be NULL. |
SendSync(const TMMFMessageDestinationPckg &, TInt, const TDesC8 &, const TDesC8 &)
Send a message synchronously to the controller thread.
The controller framework will analyze the message to determine its correct destination.
Note: This method will not return until the controller framework has serviced the command.
Parameters
const TMMFMessageDestinationPckg & aDestination | The destination of the message, consisting of the uid of the interface of this message. |
TInt aFunction | The function number to indicate which function is to be called on the interface defined in the aDestination parameter. |
const TDesC8 & aDataTo1 | A reference to the first chunk of data to be copied to the controller framework. The exact contents of the data are dependent on the interface being called. Can be NULL. |
const TDesC8 & aDataTo2 | A reference to the second chunk of data to be copied to the controller framework. The exact contents of the data are dependent on the interface being called. Can be NULL. |
SendSync(TInt, const TIpcArgs &)
SetThreadPriority(const TThreadPriority &)
Set the priority of the controller's sub thread.
This can be used to increase the responsiveness of the audio plugin to minimise any lag in processing. This function should be used with care as it may have knock-on effects elsewhere in the system.
Parameters
const TThreadPriority & aPriority | The TThreadPriority that the thread should run under. The default is EPriorityNormal. |
ThreadTerminated()
The controller subthread has been terminated.
This is called by CLogonMonitor when the the thread terminates
Member Enumerations Documentation
Enum anonymous
Enumerators
EFlagOpenedSharedHeap = 0x01 |
Shared heap has been opened for this object, and must be closed
|
Member Data Documentation
TMMFMessageDestinationPckg
iDestinationPckg
Used to hold destination for messages from the controller proxy (not from clients calling SendSync/SendAsync!!)
CLogonMonitor * iLogonAO
Used to determine the success of a logon. If the status is not pending, the logon has failed and the thread should be closed.
TInt
iReserved1
This member is internal and not intended for use.
RThread
iSubThread
The thread in which the controller plugin will run.
TThreadPriority
iThreadPriority
The priority at which the controller plugin thread runs.
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.