/**

* Handles events from the kernel, filters them according to the debug agent's requests, 

* and signals these events to the user side in FIFO-style. 

* @see TKernelEventAction

* @see TEventInfo

*/

	void GetEvent(TClientDataRequest<Debug::TEventInfo>* aAsyncGetValueRequest, DThread* aClientThread);

	void QueueEvent(const TDriverEventInfo& aEventInfo);

	void IncrementHeadPosition(void);

	void IncrementTailPosition(void);

	void LockEventQueue(void);

	void UnlockEventQueue(void);

	/**

	* Object used to write events back to DSS thread

	* @see TEventInfo

	*/

	/** 

	* Ring buffer of pending events. Access to it is controlled by 

	* @see iEventQueueLock

	*/

	RArray<TDriverEventInfo> iEventQueue;

	/**

	* Ring buffer head. Points to the next empty slot in iEventQueue

	* @see iEventQueue

	*/

	TInt iHead;	

	/**

	* Ring buffer tail. Points to the oldest full slot in iEventQueue

	* @see iEventQueue 

	*/

	TInt iTail;

	/** 

	* Control access to event queue.

	* @see iEventQueue

	*/

	DSemaphore* iEventQueueLock;

	/**

	* Keeps track of how many free slots are available in the event queue.

	* @see iEventQueue

	*/

	TInt iFreeSlots;

	/**

	* Boolean to indicate if we have told the agent that we are ignoring trace events

	* @see QueueEvent

	*/

	TBool iIgnoringTrace;

	/**

	* Used to control the delivery of events to the client so that only 

	* when more requests than deliveries have taken place can we deliver the 

	* next event

	* 

	* Incremented when a request for event takes place

	* @see GetEvent

	* 

	* Decremented when an event is delivered. 

	* @see NotifyEvent

	* 

	* Cleared when event requests are cancelled

	* @see CancelGetEvent

	* 

	*/

	TInt   iEventBalance;

	/**

	* Length of kernel-event queue.

	* This is a power of two for efficiency when using the 

	* remainder operator

	* @see DDebugAgent::iEventQueue

	*/

	static const TUint KNumberOfEventsToQueue = 128;

	/**

	* This determines the number of events at which we stop accepting 

	* low priority events into the event queue.

	* @see DDebugAgent::BufferAtCriticalLevel

	* @see DDebugAgent::iEventQueue

	*/

	static const TUint KCriticalBufferSize = 64;