diff -r 000000000000 -r c40eb8fe8501 wlan_bearer/wlanengine/wlan_symbian/wlanengine_symbian_3.1/inc/wlanmgmtframehandler.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/wlan_bearer/wlanengine/wlan_symbian/wlanengine_symbian_3.1/inc/wlanmgmtframehandler.h Tue Feb 02 02:03:13 2010 +0200 @@ -0,0 +1,152 @@ +/* +* Copyright (c) 2002-2009 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: Active object to send and receive management packets (EAP packets). +* +*/ + + +#ifndef WLANMGMTFRAMEHANDLER_H +#define WLANMGMTFRAMEHANDLER_H + +#include +#include "RWlanLogicalChannel.h" +#include "FrameXferBlock.h" +#include "am_platform_libraries.h" + +class RWlanLogicalChannel; +class MWlanMgmtPacket; + +/** + * Callback interface + */ +class MWlanMgmtFrameCallback + { + public: + virtual void OnFrameReceive( + const TDataBuffer::TFrameType aFrameType, + const TUint aLength, + const TUint8* const aData, + TUint8 aRcpi ) = 0; + }; + +/** + * Management packet handler. + * Active object that waits for management packets from + * driver side. + * @since S60 v3.0 + * @lib wlmserversrv.lib + */ +NONSHARABLE_CLASS( CWlanMgmtFrameHandler ) : public CActive + { +public: // Constructors and destructor + + /** + * C++ default constructor. + * @param aServiceProvider Interface to drivers. + * @param aClient Interfce to client. + */ + CWlanMgmtFrameHandler( + RWlanLogicalChannel& aServiceProvider, + MWlanMgmtFrameCallback& aClient ); + + /** + * Static constructor. + * @param aServiceProvider Interface to drivers. + * @param aClient Interfce to client. + */ + static CWlanMgmtFrameHandler* NewL( + RWlanLogicalChannel& aServiceProvider, + MWlanMgmtFrameCallback& aClient); + + /** + * Destructor. + */ + virtual ~CWlanMgmtFrameHandler(); + +public: // New functions + + /** + * Activate the handler + * Handler starts to listen for received management frames + * @since S60 v.3.1 + * @return error code + */ + TInt Start(); + + /** + * Deactivate the handler + * Handler stops to listen for received management frames + * @since S60 v.3.1 + */ + void Stop(); + + /** + * Send management packet. + * @param aFrameType The type of the frame to send. + * @param aLength The length of sent data. + * @param aData The sent data. + * @param aUserPriority The user priority of the frame. + * @param aDestination Destination MAC address. + * @param aSendUnencrypted Whether the frame must be sent unencrypted. + * @return error code + */ + TInt SendFrame( + const TDataBuffer::TFrameType aFrameType, + const TUint aLength, + const TUint8* const aData, + TUint8 aUserPriority, + const TMacAddress& aDestination, + TBool aSendUnencrypted ); + +public: // Functions from base classes + + /** + * From CActive Is executed when synchronous request is ready. + */ + void RunL(); + + /** + * From CActive Cancel synchronous request. + */ + void DoCancel(); + +private: // Functions + + /** + * By default Symbian 2nd phase constructor is private. + */ + void ConstructL(); + + /** + * Request a synchronous call for management packets. + */ + void IssueRequest(); + +private: // Data + + /** + * Interface to receive packets. + */ + RWlanLogicalChannel& iServiceProvider; + /** + * Interface to forward packets. + */ + MWlanMgmtFrameCallback& iClient; + /** + * Data transfer buffer. Not owned by this pointer. + */ + RFrameXferBlock* iDataBlock; + }; + +#endif // WLANMGMTFRAMEHANDLER_H