author | hgs |
Fri, 18 Jun 2010 09:56:50 +0300 | |
changeset 30 | 7d966ab5304a |
parent 13 | ab7247ff6ef9 |
child 43 | d3d7683d16f5 |
permissions | -rw-r--r-- |
0
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
1 |
/* |
13
ab7247ff6ef9
Revision: 201007
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
0
diff
changeset
|
2 |
* Copyright (c) 2002-2010 Nokia Corporation and/or its subsidiary(-ies). |
0
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
3 |
* All rights reserved. |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
4 |
* This component and the accompanying materials are made available |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
5 |
* under the terms of the License "Eclipse Public License v1.0" |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
6 |
* which accompanies this distribution, and is available |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
7 |
* at the URL "http://www.eclipse.org/legal/epl-v10.html". |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
8 |
* |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
9 |
* Initial Contributors: |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
10 |
* Nokia Corporation - initial contribution. |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
11 |
* |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
12 |
* Contributors: |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
13 |
* |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
14 |
* Description: Declaration of the DataFrameMemMngr class. |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
15 |
* |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
16 |
*/ |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
17 |
|
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
18 |
/* |
30 | 19 |
* %version: 13 % |
0
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
20 |
*/ |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
21 |
|
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
22 |
#ifndef DATAFRAMEMMNGR_H |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
23 |
#define DATAFRAMEMMNGR_H |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
24 |
|
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
25 |
#include "EthernetFrameMemMngr.h" |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
26 |
|
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
27 |
class WlanChunk; |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
28 |
|
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
29 |
/** |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
30 |
* Memory manager for protocol stack side client frame Rx memory |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
31 |
* |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
32 |
* @since S60 v3.1 |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
33 |
*/ |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
34 |
class DataFrameMemMngr : public DEthernetFrameMemMngr |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
35 |
{ |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
36 |
public: |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
37 |
|
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
38 |
/** Ctor */ |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
39 |
DataFrameMemMngr( |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
40 |
DWlanLogicalChannel& aParent, |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
41 |
WlanChunk*& aRxFrameMemoryPool, |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
42 |
TInt aTxFrameBufAllocationUnit ) : |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
43 |
DEthernetFrameMemMngr( aParent, aRxFrameMemoryPool ), |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
44 |
iFrameXferBlockProtoStack( NULL ), |
30 | 45 |
iUserToKernAddrOffset( 0 ), |
0
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
46 |
iTxDataChunk( NULL ), |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
47 |
iTxFrameMemoryPool( NULL ), |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
48 |
iTxFrameBufAllocationUnit ( aTxFrameBufAllocationUnit ) |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
49 |
{}; |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
50 |
|
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
51 |
/** Dtor */ |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
52 |
virtual ~DataFrameMemMngr() |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
53 |
{ |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
54 |
iFrameXferBlockProtoStack = NULL; |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
55 |
iTxDataChunk = NULL; |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
56 |
iTxFrameMemoryPool = NULL; |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
57 |
}; |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
58 |
|
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
59 |
protected: |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
60 |
|
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
61 |
/** |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
62 |
* From DEthernetFrameMemMngr |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
63 |
* Opens a handle to the allocated shared memory chunk |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
64 |
* |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
65 |
* @since S60 5.0 |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
66 |
* @param aThread |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
67 |
* @param aSharedChunkInfo |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
68 |
* @param aSharedMemoryChunk The shared memory chunk |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
69 |
* @return system wide error code, KErrNone upon success |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
70 |
*/ |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
71 |
virtual TInt DoOpenHandle( |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
72 |
DThread& aThread, |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
73 |
TSharedChunkInfo& aSharedChunkInfo, |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
74 |
DChunk* aSharedMemoryChunk ); |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
75 |
|
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
76 |
/** |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
77 |
* From DEthernetFrameMemMngr |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
78 |
* Gets called when rx frame read cycle has ended. |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
79 |
* |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
80 |
* @since S60 3.1 |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
81 |
* @param aBufferStart first element of the array that holds pointers to |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
82 |
* Rx frame meta headers |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
83 |
* @param aNumOfBuffers number of meta header pointers in the array |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
84 |
* @return ETrue if a pending user mode frame read request exists |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
85 |
* and callee should complete it, |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
86 |
* EFalse otherwise |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
87 |
*/ |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
88 |
virtual TBool DoEthernetFrameRxComplete( |
30 | 89 |
TDataBuffer*& aBufferStart, |
0
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
90 |
TUint32 aNumOfBuffers ); |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
91 |
|
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
92 |
/** |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
93 |
* From DEthernetFrameMemMngr |
30 | 94 |
* To be called when user mode client issues a frame Rx request |
0
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
95 |
* |
30 | 96 |
* @return ETrue if callee should complete the request immediately |
97 |
* as there exists Rx frame(s) which can be retrieved by the user |
|
98 |
* mode client. |
|
99 |
* EFalse otherwise |
|
0
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
100 |
*/ |
30 | 101 |
virtual TBool OnReadRequest(); |
102 |
||
0
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
103 |
/** |
30 | 104 |
* From DEthernetFrameMemMngr |
105 |
* Gets the highest priority frame (contained in a buffer allocated from |
|
106 |
* the shared memory) from the Rx queues. |
|
107 |
* Optionally frees the memory associated to a previously received frame. |
|
108 |
* |
|
109 |
* @param aFrameToFreeInUserSpace User space pointer to previously |
|
110 |
* received frame which can now be freed. |
|
111 |
* NULL if nothing to free. |
|
112 |
* @return User space pointer to the Rx frame to be handled next. |
|
113 |
* NULL, if there are no frames available. |
|
114 |
*/ |
|
115 |
virtual TDataBuffer* GetRxFrame( TDataBuffer* aFrameToFreeInUserSpace ); |
|
116 |
||
0
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
117 |
/** |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
118 |
* From DEthernetFrameMemMngr |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
119 |
* Allocates a Tx packet from the shared memory. |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
120 |
* |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
121 |
* @param aLength Length of the requested Tx buffer in bytes |
30 | 122 |
* @return User space pointer to the meta header attached to the |
123 |
* allocated packet, on success. |
|
0
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
124 |
* NULL, in case of failure. |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
125 |
*/ |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
126 |
virtual TDataBuffer* AllocTxBuffer( TUint aLength ); |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
127 |
|
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
128 |
/** |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
129 |
* From DEthernetFrameMemMngr |
30 | 130 |
* Adds the specified Tx frame (contained in the buffer allocated from the |
131 |
* shared memory) to the relevant Tx queue according to its AC (i.e. |
|
132 |
* priority). |
|
133 |
* |
|
134 |
* @param aPacketInUserSpace Meta header attached to the frame; as a user |
|
135 |
* space pointer. |
|
136 |
* @param aPacketInKernSpace If not NULL on return, the frame needs to be |
|
137 |
* discarded and this is the kernel space pointer to its meta header. |
|
138 |
* If NULL on return, the frame must not be discarded. |
|
139 |
* @param aUserDataTxEnabled ETrue if user data Tx is enabled |
|
140 |
* EFalse otherwise |
|
141 |
* @return ETrue if the client is allowed to continue calling this method |
|
142 |
* (i.e. Tx flow is not stopped). |
|
143 |
* EFalse if the client is not allowed to call this method again |
|
144 |
* (i.e. Tx flow is stopped) until it is re-allowed. |
|
145 |
*/ |
|
146 |
virtual TBool AddTxFrame( |
|
147 |
TDataBuffer* aPacketInUserSpace, |
|
148 |
TDataBuffer*& aPacketInKernSpace, |
|
149 |
TBool aUserDataTxEnabled ); |
|
150 |
||
151 |
/** |
|
152 |
* From DEthernetFrameMemMngr |
|
153 |
* Gets the frame to be transmitted next from the Tx queues. |
|
154 |
* |
|
155 |
* @param aWhaTxQueueState State (full / not full) of every WHA transmit |
|
156 |
* queue |
|
157 |
* @param aMore On return is ETrue if another frame is also ready to be |
|
158 |
* transmitted, EFalse otherwise |
|
159 |
* @return Pointer to the meta header of the frame to be transmitted, on |
|
160 |
* success |
|
161 |
* NULL, if there's no frame that could be transmitted, given the |
|
162 |
* current status of the WHA Tx queues |
|
163 |
*/ |
|
164 |
virtual TDataBuffer* GetTxFrame( |
|
165 |
const TWhaTxQueueState& aTxQueueState, |
|
166 |
TBool& aMore ); |
|
167 |
||
168 |
/** |
|
169 |
* From DEthernetFrameMemMngr |
|
0
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
170 |
* Deallocates a Tx packet. |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
171 |
* |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
172 |
* All Tx packets allocated with AllocTxBuffer() must be deallocated using |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
173 |
* this method. |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
174 |
* |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
175 |
* @param aPacket Meta header of the packet to the deallocated |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
176 |
*/ |
30 | 177 |
virtual void FreeTxPacket( TDataBuffer*& aPacket ); |
178 |
||
179 |
/** |
|
180 |
* From DEthernetFrameMemMngr |
|
181 |
* Determines if Tx from protocol stack side client should be resumed |
|
182 |
* |
|
183 |
* @param aUserDataTxEnabled ETrue if user data Tx is enabled |
|
184 |
* EFalse otherwise |
|
185 |
* @return ETrue if Tx should be resumed |
|
186 |
* EFalse otherwise |
|
187 |
*/ |
|
188 |
virtual TBool ResumeClientTx( TBool aUserDataTxEnabled ) const; |
|
189 |
||
190 |
/** |
|
191 |
* From DEthernetFrameMemMngr |
|
192 |
* Determines if all protocol stack side client's Tx queues are empty |
|
193 |
* |
|
194 |
* @return ETrue if all Tx queues are empty |
|
195 |
* EFalse otherwise |
|
196 |
*/ |
|
197 |
virtual TBool AllTxQueuesEmpty() const; |
|
0
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
198 |
|
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
199 |
private: |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
200 |
|
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
201 |
/** |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
202 |
* From DEthernetFrameMemMngr |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
203 |
* Memory finalization method. |
13
ab7247ff6ef9
Revision: 201007
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
0
diff
changeset
|
204 |
* |
ab7247ff6ef9
Revision: 201007
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
0
diff
changeset
|
205 |
* @param aThread The user mode client thread |
0
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
206 |
*/ |
13
ab7247ff6ef9
Revision: 201007
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
0
diff
changeset
|
207 |
virtual void OnReleaseMemory( DThread& aThread ); |
0
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
208 |
|
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
209 |
// Prohibit copy constructor. |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
210 |
DataFrameMemMngr( const DataFrameMemMngr& ); |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
211 |
// Prohibit assigment operator. |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
212 |
DataFrameMemMngr& operator= ( const DataFrameMemMngr& ); |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
213 |
|
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
214 |
private: // Data |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
215 |
|
30 | 216 |
/** kernel address of frame xfer block */ |
217 |
RFrameXferBlockProtocolStack* iFrameXferBlockProtoStack; |
|
218 |
||
0
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
219 |
/** |
30 | 220 |
* the offset from a User space address to the corresponding address |
221 |
* in the Kernel space in the shared memory chunk. May also be negative |
|
0
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
222 |
*/ |
30 | 223 |
TInt32 iUserToKernAddrOffset; |
0
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
224 |
|
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
225 |
/** |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
226 |
* pointer to protocol stack side Tx area start in the kernel address |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
227 |
* space |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
228 |
*/ |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
229 |
TUint8* iTxDataChunk; |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
230 |
|
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
231 |
/** |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
232 |
* Tx frame memory pool manager |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
233 |
* Own. |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
234 |
*/ |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
235 |
WlanChunk* iTxFrameMemoryPool; |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
236 |
|
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
237 |
/** |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
238 |
* size of the Tx frame buffer allocation unit in bytes |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
239 |
*/ |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
240 |
TInt iTxFrameBufAllocationUnit; |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
241 |
}; |
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
242 |
|
c40eb8fe8501
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
diff
changeset
|
243 |
#endif // DATAFRAMEMMNGR_H |