sl@0: // Copyright (c) 1999-2010 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: // Definition of classes for the class that deals with client communication
sl@0: // 
sl@0: //
sl@0: 
sl@0: #ifndef __CLIENT_H__
sl@0: #define __CLIENT_H__
sl@0: 
sl@0: #include <graphics/WSGRAPHICDRAWERINTERFACE.H>
sl@0: #include "WSGRAPHICDRAWERARRAY.H"
sl@0: 
sl@0: #include <e32std.h>
sl@0: #include <e32base.h>
sl@0: #include "W32STD.H"
sl@0: #include "w32cmd.h"
sl@0: #include "WSOBJIX.H"
sl@0: #include "EVQUEUE.H"
sl@0: #include "PRIKEY.H"
sl@0: #include "wstypes.h"
sl@0: #include <e32hashtab.h>  //RHashMap
sl@0: 
sl@0: class CWsWindowBase;
sl@0: class CWsClientWindow;
sl@0: class CWsPointerCursor;
sl@0: class CWsCustomTextCursor;
sl@0: class CWsSpriteBase;
sl@0: class DWsScreenDevice;
sl@0: class CScreen;
sl@0: class RHandleBase;
sl@0: class CWsGraphicDrawerObject;
sl@0: class CWsGraphicDrawer;
sl@0: class MWsElement;
sl@0: class TSurfaceConfiguration;
sl@0: class CWsRedrawMsgWindow;
sl@0: 
sl@0: /** Server-side object for a client session.
sl@0: 
sl@0: @internalComponent
sl@0: @released
sl@0: */
sl@0: class CWsClient : public CSession2, public MWsClient
sl@0: 	{
sl@0: private:
sl@0: 	friend class CWsRedrawMsgWindow;
sl@0: private:
sl@0: 	class TWsCursorArrayItem;
sl@0: 	enum{EObjectGranularity=5};
sl@0: 	enum{ENoDefaultSystemPointerCursor=-1};
sl@0: public:
sl@0: 	enum{EPanicLeave=1};
sl@0: public: // from MWsClient
sl@0: 	TBool HasCapability(TCapability aCapability) const;
sl@0: 	TSecureId SecureId() const;
sl@0: 	TVendorId VendorId() const;
sl@0: public:
sl@0: 	CWsClient(RThread aClient);
sl@0: 	~CWsClient();
sl@0: 	static void InitStaticsL();
sl@0: 	static void DeleteStatics();
sl@0: 	inline TBool NotClosing() const;
sl@0: 	inline CWsObjectIx* ObjectIndex();
sl@0: 
sl@0: 	inline const RMessage2& ClientMessage() const;
sl@0: 	
sl@0: 	inline const RThread& Client() const;
sl@0: 	static inline CWsClient* CurrentClient();
sl@0: 	inline TInt ConnectionHandle() const;
sl@0: 	inline DWsScreenDevice* PrimaryScreenDevice();
sl@0: 	inline const DWsScreenDevice* PrimaryScreenDevice() const;
sl@0: 	inline CScreen* Screen();
sl@0: 	inline const CScreen* Screen() const;
sl@0: 	static CWsPointerCursor* SystemPointerCursor(TInt aIndex);
sl@0: 	static inline CWsPointerCursor* DefaultSystemPointerCursor();
sl@0: 	static CWsCustomTextCursor* FindCustomTextCursor(TInt aIdentifier);
sl@0: 	void SessionPanic(TClientPanic aReason) const;
sl@0: 	
sl@0: 	// Window object access from handle
sl@0: 	void HandleToWindow(TInt aHandle, CWsWindowBase** pWin);
sl@0: 	void HandleToClientWindow(TInt aHandle, CWsClientWindow** pWin);
sl@0: 	
sl@0: 	// Generic WsObject access from handle
sl@0: 	CWsObject* HandleToObj(TInt aHandle, WH_HANDLES aType);
sl@0: 	const CWsObject* HandleToObj(TInt aHandle, WH_HANDLES aType) const;
sl@0: 	CWsObject* HandleToObjUntyped(TInt aHandle);
sl@0: 	const CWsObject* HandleToObjUntyped(TInt aHandle) const;
sl@0: 	
sl@0: 	CWsGraphicDrawerObject* DrawerObject(const CWsGraphicDrawer* aDrawer);
sl@0: 	const CWsGraphicDrawerObject* DrawerObject(const CWsGraphicDrawer* aDrawer) const;
sl@0: 	
sl@0: 	// Handle from object
sl@0: 	inline TInt ObjectHandle(const CWsObject* aThis) const;
sl@0: 	
sl@0: 	// Queue access
sl@0: 	inline CEventQueue* EventQueue();
sl@0: 	inline const CEventQueue* EventQueue() const;
sl@0: 	inline CRedrawQueue* RedrawQueue();
sl@0: 	inline const CRedrawQueue* RedrawQueue() const;	
sl@0: 	
sl@0: 	// Execute client command from buffer
sl@0: 	void ExecuteCommandL(TInt aOpcode, const TAny* aCmdData);
sl@0: 	static const TUint8* EndOfCommandBuffer();
sl@0: 	static const TPtrC BufferTPtr(TText* aStart,TInt aLen);
sl@0: 	static TBool BufferTPtrGc(TText* aStart,TInt aLen,TPtrC& aPtr);
sl@0: 	static const TPtrC8 BufferTPtr8(TUint8* aStart,TInt aLen);
sl@0: 	
sl@0: 	// Remote read data from client
sl@0: 	void RemoteRead(TDes16& aDes, TInt aOffset);
sl@0: 	void RemoteRead(TDes8& aDes, TInt aOffset);
sl@0: 	void RemoteReadL(TDes16& aDes, TInt aOffset);
sl@0: 	void RemoteReadL(TDes8& aDes, TInt aOffset);
sl@0: 
sl@0: 	// Send the reply to the client's request
sl@0: 	void SetResponseHandle(RHandleBase* aHandle);
sl@0: 	static void ReplyBuf(const TAny* aSource, TInt aLength);
sl@0: 	static void ReplyBuf(const TDesC8 &aDes);
sl@0: 	static void ReplyBuf(const TDesC16 &aDes);
sl@0: 	static void ReplySize(const TSize &aSize);
sl@0: 	static void ReplyPoint(const TPoint &aPoint);
sl@0: 	static void ReplyRect(const TRect &aRect);
sl@0: 	static void ReplyGroupName(HBufC* aName, TInt aMaxLength);
sl@0: 	static void SetReply(TInt reply);
sl@0: 	void RequestComplete(TRequestStatus*& aStatus, TInt aErr);
sl@0: 	
sl@0: 	// Panic or terminate the client
sl@0: 	static void PanicCurrentClient(TClientPanic aPanic);
sl@0: 	static TInt ReplyBufSpace()  ;
sl@0: 	void PPanic(TClientPanic aPanic) const;
sl@0: 	void SessionTerminate();
sl@0: 	
sl@0: 	// All events
sl@0: 	inline void EventReady(const RMessagePtr2& aEventMsg);
sl@0: 	
sl@0: 	// Pointer events
sl@0: 	inline void PurgePointerEvents();
sl@0: 
sl@0: 	// Key events
sl@0: 	inline void PriorityKeyPressed(TInt aHandle, const TKeyEvent &aKeyEvent);
sl@0: 
sl@0: 	// Notification of misc events
sl@0: 	void AddNotificationL(TInt aKey, const RMessage2& aClientMsg);
sl@0: 	void CompleteNotification(TInt aKey, TInt aReason);
sl@0: 	inline void NotifyScreenDeviceDeleted(DWsScreenDevice* aDeletedScreenDevice);
sl@0: 	
sl@0: 	// Redraw
sl@0: 	void TriggerRedraw();
sl@0: 
sl@0: 	// Misc
sl@0: 	void UpdateWindowOrdinalPrioritys();
sl@0: 	void SetClientPriority();	// boost when in foreground
sl@0: 
sl@0: 	void CreateDrawableSourceL(const TWsClCmdCreateDrawableSource& aDrawableSourceData);
sl@0: 
sl@0: 	//retry putting events on event queue
sl@0: 	void SetRetryFlag(TEventCode aEventCode);
sl@0: 	void RemoveRetryFlag(TEventCode aEventCode);
sl@0: 	TBool RetryEvent(TEventCode aEventCode);
sl@0: 
sl@0:     inline void WgMsgQueueOverflow();// Set flag  window group message queue is overflow and has pending messages
sl@0:     
sl@0:     //Get orientation value that app indicated
sl@0:     TInt GetIndicatedAppOrientation();
sl@0: 
sl@0: private: // from MWsClient
sl@0: 	TInt SendMessage(const CWsGraphicDrawer* aOnBehalfOf, const TDesC8& aData);
sl@0: 	TInt SendMessage(const CWsGraphicDrawer* aOnBehalfOf, CWsMessageData& aData);
sl@0: 
sl@0: private: // from CSession2
sl@0: 	void ServiceL(const RMessage2 &aMessage);
sl@0: 	void ServiceError(const RMessage2& aMessage,TInt aError);
sl@0: private:
sl@0: 	// Construction and destruction
sl@0: 	inline TBool IsInitialised();
sl@0: 	void StartInitializationL(TUint aConnectionHandle);
sl@0: 	void CompleteInitializationL();
sl@0: 	void InitialiseScreenDevices();
sl@0: 	
sl@0: 	// Service client commands by dispatching them to the object associated with the op code
sl@0: 	void DoServiceL(const RMessage2& aMessage, TBool& aCompleteRequest);
sl@0: 	void DoServiceCommandBuf();
sl@0: 	void DispatchCommandsInBufL();
sl@0: 	void CompleteMessage(const RMessage2& aMessage,TInt aReason);
sl@0: 	
sl@0: 	// Execute async client commands
sl@0: 	void ExecuteAsyncClientCommandL(TInt aOpcode, const RMessage2& aMessage);
sl@0: 	static inline TBool CheckBuffer(TInt aLength, TInt aMaxLength);
sl@0: 	static TBool DebugEnforceRedrawCallingConvention();
sl@0: 	
sl@0: 	// Create new objects
sl@0: 	void CreateNewWindowGroupL(const TWsClCmdCreateWindowGroup &aCmd);
sl@0: 	void CreateNewWindowL(const TWsClCmdCreateWindow &aCmd);
sl@0: 	void CreateNewAnimDllL(const TWsClCmdUnion &aParams);
sl@0: 	void CreateNewSpriteL(const TWsClCmdCreateSprite &aCmd);
sl@0: 	void CreateNewPointerCursorL(const TWsClCmdCreatePointerCursor &aCmd);
sl@0: 	void CreateNewBitmapL(const TWsClCmdCreateBitmap &aCmd);
sl@0: 	void CreateNewClickHandlerL(const TUid& aUid);
sl@0: 	void CreateNewScreenDeviceL( TInt aDefaultScreenNumber, TUint aClientScreenDevicePointer);
sl@0: 	
sl@0: 	// Surface management
sl@0: 	TInt RegisterSurface(const TWsClCmdUnion& pData);
sl@0: 	void UnregisterSurface(const TWsClCmdUnion& pData);
sl@0: 	
sl@0: 	// Text cursor
sl@0: 	static inline CWsCustomTextCursor*& TextCursor (TInt aPosition);
sl@0: 	void StartSetCustomTextCursorL(const TWsClCmdCustomTextCursorData& aCmd);
sl@0: 	void CompleteSetCustomTextCursorL(TInt aErr);
sl@0: 	
sl@0: 	// Pointer cursor
sl@0: 	static inline CWsPointerCursor*& PointerCursor (TInt aPosition);
sl@0: 	void SetSystemPointerCursorL(TInt aIndex, CWsPointerCursor* aCursor);
sl@0: 	void ClearSystemPointerCursor(TInt aIndex);
sl@0: 	void ClaimSystemPointerCursorListL();
sl@0: 	void FreeSystemPointerCursorList();
sl@0: 	void SetDefaultSystemPointerCursor(TInt aIndex);
sl@0: 	static void DeleteSystemPointerListEntry(TInt aIndex);
sl@0: 	
sl@0: 	static TBool FindCursorArrayItem(CArrayFixFlat<TWsCursorArrayItem>* aCursorArray,
sl@0: 									  TInt aIndex, TInt& aPosition);
sl@0: 	
sl@0: 	// Key events
sl@0: 	inline void CancelClientRequestForPriorityKeyEvent();
sl@0: 	inline void HandleClientRequestForPriorityKeyData();
sl@0: 	inline void PriorityKeyEventReady(const RMessagePtr2& aEventMsg);
sl@0: 	
sl@0: 	// Redraw events
sl@0: 	inline void CancelClientRequestForRedrawEvent();
sl@0: 	inline void HandleClientRequestForRedrawData();
sl@0: 	inline void RedrawEventReady(const RMessagePtr2& aEventMsg);
sl@0: 	inline TBool ClientProcessingRedrawEvent();
sl@0: 	
sl@0: 	// Client event requests
sl@0: 	inline void HandleClientRequestForEventData();
sl@0: 	inline void CancelClientRequestForEventData();
sl@0: 
sl@0: 	// Debugging
sl@0: 	void DebugInfoL(TInt aFunction, TInt aParam, TBool aHasReplyBuf) const;
sl@0: 	void DebugInfoUnclassifiedL(TInt aFunction, TInt aParam, TBool aHasReplyBuf) const;
sl@0: 	TInt DebugInfoClassifiedL(TInt aFunction, TInt aParam, TBool aHasReplyBuf) const;
sl@0: 	TInt DebugInfoScreenUiL(TInt aFunction, TInt aParam, TInt aReplyBufSize, CScreen& aScreen) const;
sl@0: 	TInt DebugInfoScreenElementSetL(TInt aFunction, TInt aParam, TInt aReplyBufSize,const CScreen& aScreen) const;
sl@0: 	TInt DebugInfoElementSetWindowL(TInt aFunction, TInt aParam, TInt aReplyBufSize,const CScreen& aScreen) const;
sl@0: 	TInt DebugInfoElementSetElementL(TInt aFunction, TInt aParam, TInt aReplyBufSize,const CScreen& aScreen) const;
sl@0: 	TInt DebugReturnConfig(TInt aReplyBufSize, MWsElement* aElement, TInt aFlags=0)const;
sl@0: 	TInt DebugReturnBase(TInt aReplyBufSize, const MWsElement* aElement) const;
sl@0: 	TInt DebugReturnFlags(TInt aReplyBufSize, const MWsElement* aElement, TInt aFlags=0) const;
sl@0: 	TInt DebugReturnRegion(TInt aReplyBufSize, const TRegion* aRegion, TInt aErrCodeIfEmpty) const;	
sl@0: 	
sl@0: 	// Misc
sl@0: 	void SetComputeMode(RWsSession::TComputeMode aComputeMode);
sl@0: 	
sl@0: 	//Set orientation that application indicated
sl@0: 	void IndicateAppOrientation(TRenderOrientation aOrientation);
sl@0: 	
sl@0: public:
sl@0: 	static TWsCmdHeaderBase iCurrentCommand;
sl@0: private:
sl@0: 	class TWsCursorArrayItem
sl@0: 		{
sl@0: 	public:
sl@0: 		CWsSpriteBase* iCursor;
sl@0: 		TInt iIndex;
sl@0: 		};
sl@0: 
sl@0: 	enum TInternalFlags
sl@0: 		{
sl@0: 		EIsInitialised = 0x01,
sl@0: 		EPanicClientAsSoonAsPossible = 0x02,		//The client should be panicked, but we have no way to panic him now
sl@0: 		EClientIsClosing = 0x04,		//The client is closing down, so the screen device may no longer be valid
sl@0: 		EFinishedProcessingCommands=0x08,	//Reached last command in command buffer or otherwised finihsed processing it
sl@0: 		ERemoveKeyCode=0x10,		//Remove the Win32 keycode emulator only
sl@0: 		ERetryDisplayEvent=0x20,
sl@0: 		EIsPerformingRedrawEvent=0x40,         //The client is performing a RedrawEvent
sl@0: 		EWgMsgQueueOverflow =0x80,
sl@0: 		};
sl@0: private:
sl@0: 	RThread iClient;
sl@0: 	CScreen* iScreen;		//## This needs updating
sl@0: 	TUint iConnectionHandle; // Connection ID, only needed for logging, could bin this
sl@0: 	CEventQueue* iEventQueue;
sl@0: 	CRedrawQueue* iRedrawQueue;
sl@0: 	CPriorityKey* iPriorityKeyEvent;
sl@0: 	CWsGraphicMessageQueue iGraphicMessageQueue;
sl@0: 	RWsSession::TComputeMode iComputeMode;
sl@0: 	CWsObjectIx* iObjectIndex;
sl@0: 	DWsScreenDevice* iPrimaryScreenDevice;
sl@0: 	TWsCursorArrayItem iTempCustomTextCursor;
sl@0: 	mutable TInt iPanicReason;
sl@0: 	mutable TUint iInternalFlags;
sl@0: 	RMessage2 iClientMessage;
sl@0: 	RHandleBase* iResponseHandle;
sl@0: 	TInt iMessageIdSeq;
sl@0: 	TInt iIndicatedAppOrientation;
sl@0: 
sl@0: 	//Members for procerssing command buffer
sl@0: 	static CWsClient* iCurrentClient;	// Client who's buffer is currently being processed
sl@0: 	static TInt iReply;					// Value to reply
sl@0: 	static TInt iReplyOffset;			// Offset into reply to write next block of data
sl@0: 	static TBuf8<EClientBufferMaxSize> iCmdBuf; // Buffer contain a block of client commands
sl@0: 	static CWsObject* iDestObj;			// Current object client command is for
sl@0: 	static const TUint8* iNextCmd;		// Pointer in buffer to the next command to be processed
sl@0: 
sl@0: 	static TInt iDefaultSystemPointerCursorIndex;		// Negative when there isn't one
sl@0: 	static CWsPointerCursor* iDefaultSystemPointerCursor;
sl@0: 	static CArrayFixFlat<TWsCursorArrayItem>* iSystemPointerCursors;
sl@0: 	static CWsClient* iSystemPointerCursorListOwner;
sl@0: 	static CArrayFixFlat<TWsCursorArrayItem>* iTextCursorArray;
sl@0: 	static TUint iConnectionId;
sl@0: 	static TKeyArrayFix iCursorKey;
sl@0:  	static TBool iDebug_EnforceRedrawCallingConvention;
sl@0: #if defined(__WINS__)
sl@0: public:
sl@0: 	inline TBool RemoveKeyCode();
sl@0: #endif
sl@0: 	};
sl@0: 
sl@0: 
sl@0: //
sl@0: // inlines			//
sl@0: //
sl@0: 
sl@0: inline const RThread& CWsClient::Client() const
sl@0: 	{return iClient;}
sl@0: 
sl@0: inline void CWsClient::EventReady(const RMessagePtr2& aEventMsg)
sl@0: 	{iEventQueue->EventReady(aEventMsg);}
sl@0: 
sl@0: inline void CWsClient::HandleClientRequestForEventData()
sl@0:     {iEventQueue->GetData();}
sl@0: 
sl@0: inline void CWsClient::CancelClientRequestForEventData()
sl@0: 	{iEventQueue->CancelRead();}
sl@0: 
sl@0: inline void CWsClient::PurgePointerEvents()
sl@0: 	{iEventQueue->PurgePointerEvents();}
sl@0: 
sl@0: inline void CWsClient::RedrawEventReady(const RMessagePtr2& aEventMsg)
sl@0:     {
sl@0:     iInternalFlags&=~EIsPerformingRedrawEvent;
sl@0:     iRedrawQueue->EventReady(aEventMsg);
sl@0:     }
sl@0: 
sl@0: inline TBool CWsClient::ClientProcessingRedrawEvent()
sl@0: 	{return !!(iInternalFlags&EIsPerformingRedrawEvent);}
sl@0: 
sl@0: inline void CWsClient::HandleClientRequestForRedrawData()
sl@0:     {
sl@0:     iInternalFlags|=EIsPerformingRedrawEvent;
sl@0:     iRedrawQueue->GetData();
sl@0:     }
sl@0: 
sl@0: inline void CWsClient::CancelClientRequestForRedrawEvent()
sl@0: 	{iRedrawQueue->CancelRead();}
sl@0: 
sl@0: inline void CWsClient::PriorityKeyEventReady(const RMessagePtr2& aEventMsg)
sl@0:     {iPriorityKeyEvent->EventReady(aEventMsg);}
sl@0: 
sl@0: inline void CWsClient::CancelClientRequestForPriorityKeyEvent()
sl@0: 	{iPriorityKeyEvent->CancelRead();}
sl@0: 
sl@0: inline void CWsClient::HandleClientRequestForPriorityKeyData()
sl@0: 	{iPriorityKeyEvent->GetData();}
sl@0: 
sl@0: inline void CWsClient::PriorityKeyPressed(TInt aHandle, const TKeyEvent &aKeyEvent)
sl@0: 	{iPriorityKeyEvent->PriorityKey(aHandle, aKeyEvent);}
sl@0: 
sl@0: inline TInt CWsClient::ObjectHandle(const CWsObject* aThis) const
sl@0: 	{return(iObjectIndex->At(aThis));}
sl@0: 
sl@0: #if defined(__WINS__)
sl@0: inline TBool CWsClient::RemoveKeyCode()
sl@0: 	{return iInternalFlags&ERemoveKeyCode;}
sl@0: #endif
sl@0: 
sl@0: inline CEventQueue* CWsClient::EventQueue()
sl@0: 	{return(iEventQueue);}
sl@0: 
sl@0: inline const CEventQueue* CWsClient::EventQueue() const
sl@0: 	{return(iEventQueue);}
sl@0: 
sl@0: inline CRedrawQueue* CWsClient::RedrawQueue()
sl@0: 	{return(iRedrawQueue);}
sl@0: 
sl@0: inline const CRedrawQueue* CWsClient::RedrawQueue() const
sl@0: 	{return(iRedrawQueue);}
sl@0: 
sl@0: inline CWsObjectIx* CWsClient::ObjectIndex()
sl@0: 	{return(iObjectIndex);}
sl@0: 
sl@0: inline TInt CWsClient::ConnectionHandle() const
sl@0: 	{return(iConnectionHandle);}
sl@0: 
sl@0: inline DWsScreenDevice* CWsClient::PrimaryScreenDevice()
sl@0: 	{return(iPrimaryScreenDevice);}
sl@0: 
sl@0: inline const DWsScreenDevice* CWsClient::PrimaryScreenDevice() const
sl@0: 	{return(iPrimaryScreenDevice);}
sl@0: 
sl@0: inline void CWsClient::NotifyScreenDeviceDeleted(DWsScreenDevice* aDeletedScreenDevice)
sl@0: 	{
sl@0: 	if (iPrimaryScreenDevice == aDeletedScreenDevice)
sl@0: 		iPrimaryScreenDevice = NULL;
sl@0: 	}
sl@0: 
sl@0: inline CWsPointerCursor*& CWsClient::PointerCursor(TInt aIndex)
sl@0: 	{return (CWsPointerCursor*&)(*iSystemPointerCursors)[aIndex].iCursor;}
sl@0: 
sl@0: inline CWsCustomTextCursor*& CWsClient::TextCursor(TInt aIndex)
sl@0: 	{return (CWsCustomTextCursor*&)(*iTextCursorArray)[aIndex].iCursor;}
sl@0: 
sl@0: inline const RMessage2& CWsClient::ClientMessage() const
sl@0: 	{return iClientMessage;}
sl@0: 
sl@0: inline CScreen* CWsClient::Screen()
sl@0: 	{return iScreen;}
sl@0: 
sl@0: inline const CScreen* CWsClient::Screen() const
sl@0: 	{return iScreen;}
sl@0: 
sl@0: inline TBool CWsClient::NotClosing() const
sl@0: 	{return !(iInternalFlags&EClientIsClosing);}
sl@0: 
sl@0: inline CWsClient* CWsClient::CurrentClient()
sl@0: 	{return iCurrentClient;}
sl@0: 
sl@0: inline TBool CWsClient::CheckBuffer(TInt aLength, TInt aMaxLength)
sl@0: 	{return TBool((aLength>=0) && (aLength<=aMaxLength));}
sl@0: 
sl@0: inline TBool CWsClient::IsInitialised()
sl@0: 	{return iInternalFlags&EIsInitialised; }
sl@0: 
sl@0: inline void CWsClient::WgMsgQueueOverflow()
sl@0:     {iInternalFlags |= EWgMsgQueueOverflow;}
sl@0: 
sl@0: #endif