1# IWlanInterface
2
3
4## 概述
5
6定义上层WLAN服务的扩展接口。
7
8**起始版本：** 4.1
9
10**相关模块：**[WLAN](_w_l_a_n_v12.md)
11
12
13## 汇总
14
15
16### Public 成员函数
17
18| 名称 | 描述 |
19| -------- | -------- |
20| [GetApBandwidth](#getapbandwidth) ([in] String ifName, [out] unsigned char bandwidth) | 获取AP当前带宽 |
21| [ResetToFactoryMacAddress](#resettofactorymacaddress) ([in] String ifName) | 重置为出厂MAC地址(永久硬件地址) |
22| [SendActionFrame](#sendactionframe) ([in] String ifName, [in] unsigned int freq, [in] unsigned char[] frameData) | 向驱动程序发送动作帧 |
23| [RegisterActionFrameReceiver](#registeractionframereceiver) ([in] String ifName, [in] unsigned char[] match) | 寄存器动作帧接收机 |
24| [SetPowerSaveMode](#setpowersavemode) ([in] String ifName, [in] int frequency, [in] int mode) | 设置节能管理器模式 |
25| [SetDpiMarkRule](#setdpimarkrule) ([in] int uid, [in] int protocol, [in] int enable) | 设置数据包标识标记规则 |
26
27
28## 成员函数说明
29
30
31### GetApBandwidth()
32
33```
34IWlanInterface::GetApBandwidth ([in] String ifName, [out] unsigned char bandwidth )
35```
36
37**描述**
38
39
40获取AP当前带宽
41
42**起始版本：** 4.1
43
44**参数:**
45
46| 名称 | 描述 |
47| -------- | -------- |
48| ifName | 表示网卡(NIC)名称 |
49| bandwidth | AP带宽： 1(20M), 2(40M), 4(80M), 8(160M) |
50
51**返回：**
52
53如果操作成功，则返回0。
54
55如果操作失败，则为负值。
56
57
58### RegisterActionFrameReceiver()
59
60```
61IWlanInterface::RegisterActionFrameReceiver ([in] String ifName, [in] unsigned char[] match )
62```
63
64**描述**
65
66
67寄存器动作帧接收机
68
69**起始版本：** 4.1
70
71**参数:**
72
73| 名称 | 描述 |
74| -------- | -------- |
75| ifName | 表示网卡(NIC)名称 |
76| txChannel | 表示数据匹配操作框架 |
77
78**返回：**
79
80如果操作成功，则返回0。
81
82如果操作失败，则为负值。
83
84
85### ResetToFactoryMacAddress()
86
87```
88IWlanInterface::ResetToFactoryMacAddress ([in] String ifName)
89```
90
91**描述**
92
93
94重置为出厂MAC地址(永久硬件地址)
95
96**起始版本：** 4.1
97
98**参数:**
99
100| 名称 | 描述 |
101| -------- | -------- |
102| ifName | 表示网卡(NIC)名称 |
103
104**返回：**
105
106如果操作成功，则返回0。
107
108如果操作失败，则为负值。
109
110
111### SendActionFrame()
112
113```
114IWlanInterface::SendActionFrame ([in] String ifName, [in] unsigned int freq, [in] unsigned char[] frameData )
115```
116
117**描述**
118
119
120向驱动程序发送动作帧
121
122**起始版本：** 4.1
123
124**参数:**
125
126| 名称 | 描述 |
127| -------- | -------- |
128| ifName | 表示网卡(NIC)名称 |
129| freq | 表示发送通道频率 |
130| ifName | 表示动作帧数据 |
131
132**返回：**
133
134如果操作成功，则返回0。
135
136如果操作失败，则为负值。
137
138
139### SetDpiMarkRule()
140
141```
142IWlanInterface::SetDpiMarkRule ([in] int uid, [in] int protocol, [in] int enable )
143```
144
145**描述**
146
147
148设置数据包标识标记规则
149
150**起始版本：** 4.1
151
152**参数:**
153
154| 名称 | 描述 |
155| -------- | -------- |
156| uid | 表示目标应用程序UID |
157| protocol | 表示目标协议类型，tcp/udp |
158| enable | 指示启用/禁用dpi标记规则 |
159
160**返回：**
161
162如果操作成功，则返回0。
163
164如果操作失败，则为负值。
165
166
167### SetPowerSaveMode()
168
169```
170IWlanInterface::SetPowerSaveMode ([in] String ifName, [in] int frequency, [in] int mode )
171```
172
173**描述**
174
175
176设置节能管理器模式
177
178**起始版本：** 4.1
179
180**参数:**
181
182| 名称 | 描述 |
183| -------- | -------- |
184| ifName | 表示网卡(NIC)名称 |
185| frequency | 表示连接的ap频率 |
186| mode | 表示省电模式：3（启用省电），4（禁用省电） |
187
188**返回：**
189
190如果操作成功，则返回0。
191
192如果操作失败，则为负值。
193