Location:
mmfcontrollerframework.h
Link against: mmfcontrollerframework.lib
class TMMFMessage;
Encapsulation of an RMessage or an RMessage2
to provide protection to controller plugins from the changes occurring with secure APIs.
Adds required destination information to the message so the controller framework can determine which object the message is for.
Adds capability to check whether the message has been completed.
Allows two descriptors to be read from the client, and one descriptor to be copied to the client.
Defined in TMMFMessage
:
AdoptFileHandleFromClientL()
, Complete()
, Destination()
, FetchDestinationL()
, Function()
, IsCompleted()
, ReadData1FromClient()
, ReadData1FromClientL()
, ReadData2FromClient()
, ReadData2FromClientL()
, SizeOfData1FromClient()
, SizeOfData2FromClient()
, TMMFMessage()
, TMMFMessage()
, WriteDataToClient()
, WriteDataToClientL()
IMPORT_C TMMFMessage(const TMMFMessage &aMessage);
Copy constructor.
A controller plugin should use this to take a copy of the message when it must wait for some other event before completing it.
|
IMPORT_C TMMFMessage(const RMmfIpcMessage &aMessage);
Constructs a TMMFMessage from an RMmfIpcMessage.
|
IMPORT_C const TMMFMessageDestination &Destination();
Returns the destination of the message.
|
IMPORT_C TInt Function();
Returns an integer describing the function being called. Equivalent to RMessage::Function().
|
IMPORT_C TInt SizeOfData1FromClient();
Returns the size of the first descriptor that can be copied over from the client.
Use this to create a descriptor of appropriate size before reading the data from the client.
|
IMPORT_C TInt ReadData1FromClient(TDes8 &aDes);
Copy the first descriptor from the client.
|
|
IMPORT_C void ReadData1FromClientL(TDes8 &aDes);
Copy the first descriptor from the client.
This functino can leave with one of the system-wide error codes. In particular, the leave code KErrBadDescriptor will be used if the client did not provide a valid descriptor.
|
IMPORT_C TInt SizeOfData2FromClient();
Returns the size of the second descriptor that can be copied over from the client.
Use this to create a descriptor of appropriate size before reading the data from the client.
|
IMPORT_C TInt ReadData2FromClient(TDes8 &aDes);
Copies the second descriptor from the client.
|
|
IMPORT_C void ReadData2FromClientL(TDes8 &aDes);
Copies the second descriptor from the client.
This function can leave with one of the system-wide error codes. In particular, the leave code KErrBadDescriptor will be used if the client did not provide a valid descriptor.
|
IMPORT_C TInt WriteDataToClient(const TDesC8 &aDes);
Copies data back to the client.
|
|
IMPORT_C void WriteDataToClientL(const TDesC8 &aDes);
Copies the data back to the client.
This function can leave with one of the system-wide error codes. In particular, the leave code KErrBadDescriptor will be used if the client did not provide a valid descriptor.
|
IMPORT_C void Complete(TInt aReason);
Signals to the client that its request has been completed.
Equivalent to RMessage::Complete.
|
IMPORT_C void AdoptFileHandleFromClientL(TInt aFsHandleIndex, TInt aFileHandleIndex, RFile &aFile);
|
IMPORT_C TBool IsCompleted();
Checks whether this message has already been completed.
|
IMPORT_C void FetchDestinationL();
Gets the destination info from the client.