Collapse all Symbian^3 Application Developer Library

MRemConTargetSelectorPluginInterfaceV2 Class Reference

class MRemConTargetSelectorPluginInterfaceV2 : public MRemConTargetSelectorPluginInterface

Additional functions for TSP Interface V2

Inherits from

MRemConTargetSelectorPluginInterfaceV2
- MRemConTargetSelectorPluginInterface

Public Member Functions
void	AddressIncomingNotify ( TUid , TUint , TSglQue < TClientInfo > &)
void	CancelOutgoingResponse ()
void	PermitOutgoingResponse ( TUid , TUint , const TClientInfo &, TClientInfoConstIter &)

Inherited Functions
	MRemConTargetSelectorPluginInterface::AddressIncomingCommand(TUid,TUint,TSglQue< TClientInfo > &)
	MRemConTargetSelectorPluginInterface::AddressOutgoingCommand(TUid,TUint,const TClientInfo &,TSglQue< TRemConAddress > &,TSglQue< TBearerSecurity > &)
	MRemConTargetSelectorPluginInterface::CancelOutgoingCommand()
	MRemConTargetSelectorPluginInterface::PermitOutgoingCommand(TUid,TUint,const TClientInfo &,const TRemConAddress &)

Member Functions Documentation

AddressIncomingNotify(TUid, TUint, TSglQue< TClientInfo > &)

void	AddressIncomingNotify	(	TUid	aInterfaceUid,
			TUint	aOperationId,
			TSglQue < TClientInfo > &	aClients
		)	[pure virtual]

Called by RemCon to get the TSP to address an incoming notify (from a remote to zero or more target clients). The implementor should call IncomingNotifyAddressed on the observer with a pointer to the chosen client (or NULL if no client is to be addressed) from the list, and a suitable error.

Parameters

TUid aInterfaceUid	The UID of the client interface.
TUint aOperationId	The operation ID of the command.
TSglQue < TClientInfo > & aClients	A collection of existing target clients. The implementor may wish to start a target client and call IncomingNotifyAddressed with a new TClientInfo. The new TClientInfo item must be made on the stack. Note when creating the new TClientInfo, only the process ID needs to be correctly populated.

CancelOutgoingResponse()

void

CancelOutgoingResponse

(

)

[pure virtual]

Called by RemCon to cancel the current PermitOutgoingResponse request. On receipt, the TSP must stop dereferencing any data given in the PermitOutgoingResponse request. The TSP should not subsequently call OutgoingResponsePermitted, except in response to a subsequent new PermitOutgoingResponse request.

PermitOutgoingResponse(TUid, TUint, const TClientInfo &, TClientInfoConstIter &)

void	PermitOutgoingResponse	(	TUid	aInterfaceUid,
			TUint	aOperationId,
			const TClientInfo &	aClient,
			TClientInfoConstIter &	aClients
		)	[pure virtual]

Called by RemCon to get the TSP to decide which client should be allowed to respond to a command. This function is called as soon as each client returns a response, so the order in which clients are offered to the TSP is not predetermined. Since AV/C expects only a single response, the first response allowed by the TSP is the one which will be sent on-air. The initial list of clients will be populated from the TSP's response to AddressIncomingCommand() .

Parameters

TUid aInterfaceUid	The UID of the client interface.
TUint aOperationId	The operation ID of the command.
const TClientInfo & aClient	The client which is trying to send a response
TClientInfoConstIter & aClients	A list of clients which are still expected to respond, including the one specified in aClient