wlan_bearer/wlanengine/wlan_symbian/wlanengine_symbian_3.1/inc/wlanmgmtframehandler.h
changeset 0 c40eb8fe8501
--- /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 <e32base.h>
+#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