首页
社区
课程
招聘
问答 CTF 排行榜 知识库 工具下载 峰会 看雪商城 证书查询
  1. 社区
  2. 编程技术
    3. 发新帖
7
[原创]NDIS Filter Drivers指南
发表于: 2014-1-16 17:36 34555

[原创]NDIS Filter Drivers指南

vector 活跃值
2
2014-1-16 17:36
34555

不多话了，发一个自己汇集编辑的资料，关于NDIS FILTER的，主要来源于MSDN。分享给有需要的朋友。祝大家新年快乐。

NDIS Filter Drivers
SamllBug
2010/10/18

译者序
本文是根据DDK中相关章节翻译，本人英语水有限文中难免有翻译及写的不当之处，如
果有任何问题可以通LZIOG@163.com邮件联系和交流。

1 介绍NDIS Filter Drivers

ilter Drivers提供了针对微端口驱动（Miniport Drivers）的过滤服务（filtering service），
NDIS驱动栈上必须包含微端口驱动（Miniport Drivers）和协议驱动（Protocol Drivers），可选
的包含 Filter  Drivers。更多关于 NDIS驱动栈的信息可查看 DDK的 MSDN中的 Driver  Stack
Management。下面列举基本的栈配置图示：


下面的应用可能就需要一个 Filter Drivers 来完成：

1) 基于安全或其它目录的数据过滤应用

2) 对网络数据进行监视，收集及统计的应用

下面的几个小节将介绍 Filter Drivers 的一些特性和服务。

1.1 Filter Drivers  特性

Filter Drivers 主要包括以下特性:

1) 一个 Filter Drivers 实例叫 Filter Module。Filter Module 附加在一个适配器的微端口驱动上，
来自相同或不同 Filter Drivers 的多个 Filter Module 都可以被堆叠在一个网络适配器上

2)在 Filter Module 被安装到驱动栈时，之上的协议驱动和之下的微端口驱动都不需要提供
额外的支持功能

3)因为 Filter Module 不像中间层驱动（intermediate driver）那样提供一个虚拟的微口，也
不与某个设备对象联结，所以在微端口适配器(miniport adapter)之上的 Filter Module  功
能相当于一个修过过版本的微端口适配器(miniport adapter)。 原文：Because filter drivers
do  not  implement  virtual  miniports  like  an  intermediate  driver,  filter  drivers  are  not
associated with a device object. A miniport adapter with overlying filter modules functions as
a modified version of the miniport adapter.）

4)NDIS 使用配置信息来到决定一个 Filter Module 附加到一个网络适配器栈上的顺序

5)在不用拆除整驱动栈的情况下，NDIS 可以动态的插入、删除 Filter Module 或进行重新配
置

6)当 NDIS 重起驱动栈的时候协议驱动可以获得在栈上的 Filter Module 列表

7)Filter Drivers 可以过滤下层网络适配器上绝大部分的通信。Filter Module 不联结某特定的
绑定(Filter  modules  are  not  associated  with  any  particular  binding  between  overlying
protocol drivers and the miniport adapter.)

8)Filter  Drivers  可以选择为过滤服务也可以选择为分流的不过滤服务，选择为哪一种是可
以动态配置的（Filter drivers can select the services that are filtered and can be bypassed for
the  services  that  are  not  filtered.  The  selection  of  the  services  that  are  bypassed  and  the
services that are filtered can be reconfigured dynamically.）

9)NDIS  保证有效的上下文空间，也不就是说 Filter Drivers 不要需要通代码 COPY 缓冲区来
获得上下文空间

1.2 Filter Drivers  服务

Filter Drivers  提供发下服务：

1) 发起一个发送请求和接收指示

2) 改变数据缓冲区的顺序或对发送和接收数据进行调速

3) 在一个驱动栈的接收或发送路径上更改、删除、添加数据

4) 发起查询或设置 OID 的请求给下层驱动

5) 过滤对下层驱动的 OID 查询或设置请求

6) 过滤从下层驱动传来的 OID 查询和设置请求的应答

7) 发起一个状态指示给上层的设备

8) 过滤从下层传来的状态指示

9) 管理注册表中每一个微端口适配器和其接口的参数

1.3 Filter Drivers  类型

下面是两种主要类型的 Filter Drivers：

1) Monitoring
这种类型可以在驱动栈上做监视行为，但是它不能在驱动栈上进行数据修改行为。
Monitoring Filter Drivers 不在修改或发起数据。

2) Modifying
这种类型可以在驱动栈上做更改行为，该类修改类型是特定于驱动的（ The  type  of
modification is driver‐specific）。
在驱动的安装 INF 文件中 FilterType 的值是 0x00000001 就是一个 monitoring filter，如果
是 0x00000002 就是一个 modifying filter。

你可以指定一个过滤驱动是 mandatory（强制）的(也是在配置 INF 文件中指定个特征)，
它通常用在 modifying filter 驱动上，如果一个 mandatory 的 Filter  驱动不能被加载，那么它
联结的驱动栈将被拆除。

1.4 Mandatory Filter Drivers

Mandatory  Filter  Drivers 必须存在于驱动栈上，驱动栈才能正常工作。如果一个
Mandatory Filter Module 不附加，那么驱动栈也将会被拆除。Modifying 或 Monitoring 类型的
Filter Drivers 可以被指定为 Mandatory（强制）的。  所有中间层过滤驱动（filter intermediate
drivers）都是可选的（与 Mandatory 相对，就是说如果不存在驱动栈也不被拆除）

要附加一个 Mandatory Filter Drivers 在一个驱动栈上，NDIS 先解绑定所有协议驱动，附
加 Filter Module 后再重新绑定协议驱动。如果不能成功附加 Filter Drivers 那么拆除驱动栈的
下边界。

要分离一个 Mandatory Filter Drivers 在一个驱动栈上，NDIS  先解绑定所有协议驱动，分
离 Filter Module 后重新绑定协议驱动。要分离一个 optional Filter Drivers（可选 Filter Drivers，
与 Mandatory（强制）  Filter Drivers 相对）时，NDIS 只暂停驱动栈，分离后重起驱动栈这时
并不解绑定协议驱动。

如果计算机重起，如果一个 Mandatory  Filter  Drivers 还没有附加到微端口适配器
（miniport adapter）这时 NDIS 是不会绑定协议驱动的。

在安装时用的 INF 文件中指是驱动是 Mandatory 还是 Optional。在 INF 文件在指定
FilterRunType 为 0x00000001 代表驱动是 Mandatory，指定 0x00000002 代表是 Optional。

下面列出 DDK 所有例子 filter 中的 INF 文件的一个相关节，内容如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
;‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐
; Ndi installation support
;‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐
[Inst_Ndi]
HKR, Ndi,Service,,"NdisMon"
HKR, Ndi,CoServices,0x00010000,"NdisMon"
HKR, Ndi,HelpText,,%NdisMon_HelpText%
HKR, Ndi,FilterClass,, compression
[COLOR="Blue"]HKR, Ndi,FilterType,0x00010001,0x00000001 [/COLOR]
HKR, Ndi\Interfaces,UpperRange,,"noupper"
HKR, Ndi\Interfaces,LowerRange,,"nolower"
HKR, Ndi\Interfaces, FilterMediaTypes,,"ethernet"
[COLOR="Red"]HKR, Ndi,FilterRunType, 0x00010001, 1  [/COLOR]
1
2
3
4
5
6
7
8
9
10
11
12
13
NDIS_STATUS
 
NdisFRegisterFilterDriver(
 
IN PDRIVER_OBJECT DriverObject,
 
IN NDIS_HANDLE FilterDriverContext,
 
IN PNDIS_FILTER_DRIVER_CHARACTERISTICS FilterCharacteristics,
 
OUT PNDIS_HANDLE NdisFilterDriverHandle
 
);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
typedef struct _NDIS_FILTER_DRIVER_CHARACTERISTICS {
  
NDIS_OBJECT_HEADER  Header;
  
UCHAR  MajorNdisVersion;
UCHAR  MinorNdisVersion;
UCHAR  MajorDriverVersion;
UCHAR  MinorDriverVersion;
ULONG  Flags;
NDIS_STRING  FriendlyName;
NDIS_STRING  UniqueName;
NDIS_STRING  ServiceName;
SET_OPTIONS_HANDLER  SetOptionsHandler;
FILTER_SET_FILTER_MODULE_OPTIONS_HANDLER  SetFilterModuleOptionsHandler;
FILTER_ATTACH_HANDLER  AttachHandler;
FILTER_DETACH_HANDLER  DetachHandler;
FILTER_RESTART_HANDLER  RestartHandler;
FILTER_PAUSE_HANDLER  PauseHandler;
FILTER_SEND_NET_BUFFER_LISTS_HANDLER  SendNetBufferListsHandler;
FILTER_SEND_NET_BUFFER_LISTS_COMPLETE_HANDLER  SendNetBufferListsCompleteHandler;
FILTER_CANCEL_SEND_HANDLER  CancelSendNetBufferListsHandler;
FILTER_RECEIVE_NET_BUFFER_LISTS_HANDLER  ReceiveNetBufferListsHandler;
FILTER_RETURN_NET_BUFFER_LISTS_HANDLER  ReturnNetBufferListsHandler;
FILTER_OID_REQUEST_HANDLER  OidRequestHandler;
FILTER_OID_REQUEST_COMPLETE_HANDLER  OidRequestCompleteHandler;
FILTER_CANCEL_OID_REQUEST_HANDLER  CancelOidRequestHandler;
FILTER_DEVICE_PNP_EVENT_NOTIFY_HANDLER  DevicePnPEventNotifyHandler;
FILTER_NET_PNP_EVENT_HANDLER  NetPnPEventHandler;
FILTER_STATUS_HANDLER  StatusHandler;
FILTER_DIRECT_OID_REQUEST_HANDLER  DirectOidRequestHandler;
FILTER_DIRECT_OID_REQUEST_COMPLETE_HANDLER  DirectOidRequestCompleteHandler;
FILTER_CANCEL_DIRECT_OID_REQUEST_HANDLER  CancelDirectOidRequestHandler;
  
 
} NDIS_FILTER_DRIVER_CHARACTERISTICS, *PNDIS_FILTER_DRIVER_CHARACTERISTICS;
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
NDIS_STATUS
DriverEntry(
IN PDRIVER_OBJECT   DriverObject,
IN PUNICODE_STRING  RegistryPath
)
{
NDIS_STATUS               Status;
NDIS_FILTER_DRIVER_CHARACTERISTICS   FChars;
NDIS_STRING               ServiceName;
NDIS_STRING               UniqueName;
NDIS_STRING               FriendlyName;
 
 
DEBUGP(DL_TRACE,("===>DriverEntry...\n"));
 
 
RtlInitUnicodeString(&ServiceName, FILTER_SERVICE_NAME);
RtlInitUnicodeString(&FriendlyName, FILTER_FRIENDLY_NAME);
RtlInitUnicodeString(&UniqueName, FILTER_UNIQUE_NAME);
FilterDriverObject = DriverObject;
 
 
do
{
NdisZeroMemory(&FChars, sizeof(NDIS_FILTER_DRIVER_CHARACTERISTICS));
FChars.Header.Type = NDIS_OBJECT_TYPE_FILTER_DRIVER_CHARACTERISTICS;
FChars.Header.Size = sizeof(NDIS_FILTER_DRIVER_CHARACTERISTICS);
FChars.Header.Revision = NDIS_FILTER_CHARACTERISTICS_REVISION_1;
FChars.MajorNdisVersion = FILTER_MAJOR_NDIS_VERSION;
FChars.MinorNdisVersion = FILTER_MINOR_NDIS_VERSION;
FChars.MajorDriverVersion = 1;
FChars.MinorDriverVersion = 0;
FChars.Flags = 0;
 
 
FChars.FriendlyName = FriendlyName;
FChars.UniqueName = UniqueName;
FChars.ServiceName = ServiceName;
 
 
//
// for the time being, there is no additional options to register
// but let's have this handler anyway
//
FChars.SetOptionsHandler = FilterRegisterOptions;
FChars.AttachHandler = FilterAttach;
FChars.DetachHandler = FilterDetach;
FChars.RestartHandler = FilterRestart;
FChars.PauseHandler = FilterPause;
FChars.SetFilterModuleOptionsHandler = FilterSetModuleOptions;
FChars.OidRequestHandler = FilterOidRequest;
FChars.OidRequestCompleteHandler = FilterOidRequestComplete;
FChars.CancelOidRequestHandler = FilterCancelOidRequest;
 
 
FChars.SendNetBufferListsHandler = FilterSendNetBufferLists;
FChars.ReturnNetBufferListsHandler = FilterReturnNetBufferLists;
FChars.SendNetBufferListsCompleteHandler =
FilterSendNetBufferListsComplete;
FChars.ReceiveNetBufferListsHandler = FilterReceiveNetBufferLists;
FChars.DevicePnPEventNotifyHandler = FilterDevicePnPEventNotify;
FChars.NetPnPEventHandler = FilterNetPnPEvent;
FChars.StatusHandler = FilterStatus;
FChars.CancelSendNetBufferListsHandler = FilterCancelSendNetBufferLists;
 
 
DriverObject->DriverUnload = FilterUnload;
FilterDriverHandle = NULL;
 
 
FILTER_INIT_LOCK(&FilterListLock);
 
 
InitializeListHead(&FilterModuleList);
 
 
Status = NdisFRegisterFilterDriver(DriverObject,
(NDIS_HANDLE)FilterDriverObject,
&FChars,
&FilterDriverHandle);
if (Status != NDIS_STATUS_SUCCESS)
{
DEBUGP(DL_WARN, ("MSFilter: Register filter driver failed.\n"));
break;
}
//
// Initilize spin locks
//
 
 
Status = FilterRegisterDevice();
 
 
if (Status != NDIS_STATUS_SUCCESS)
{
NdisFDeregisterFilterDriver(FilterDriverHandle);
FILTER_FREE_LOCK(&FilterListLock);
DEBUGP(DL_WARN, ("MSFilter: Register device for the filter driver
failed.\n"));
break;
}
 
 
 
}
while(FALSE);
 
 
 
DEBUGP(DL_TRACE, ("<===DriverEntry, Status = %8x\n", Status));
return Status;
 
 
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
VOID
FilterUnload(
IN PDRIVER_OBJECT   DriverObject
)
{
DEBUGP(DL_TRACE, ("===>FilterUnload\n"));
//
// Should free the filter context list
//
FilterDeregisterDevice();
NdisFDeregisterFilterDriver(FilterDriverHandle);
 
 
#if DBG
FILTER_ACQUIRE_LOCK(&FilterListLock, FALSE);
ASSERT(IsListEmpty(&FilterModuleList));
 
 
FILTER_RELEASE_LOCK(&FilterListLock, FALSE);
 
 
#endif
 
 
FILTER_FREE_LOCK(&FilterListLock);
 
 
DEBUGP(DL_TRACE, ("<===FilterUnload\n"));
 
 
return;
 
 
}
1
2
3
4
5
6
7
NDIS_STATUS
FilterAttach(
  
IN NDIS_HANDLE  NdisFilterHandle,
IN NDIS_HANDLE  FilterDriverContext,
IN PNDIS_FILTER_ATTACH_PARAMETERS  AttachParameters
);
1
2
3
4
5
6
7
NDIS_STATUS
NdisFSetAttributes(
  
IN NDIS_HANDLE  NdisFilterHandle,
IN NDIS_HANDLE  FilterModuleContext,
IN PNDIS_FILTER_ATTRIBUTES  FilterAttributes
);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
NDIS_STATUS
FilterAttach(
IN NDIS_HANDLE           NdisFilterHandle,
IN NDIS_HANDLE           FilterDriverContext,
IN PNDIS_FILTER_ATTACH_PARAMETERS AttachParameters
)
{
PMS_FILTER       pFilter = NULL;
NDIS_STATUS      Status = NDIS_STATUS_SUCCESS;
PFL_NDIS_FILTER_LIST FilterHandleEntry;
NDIS_FILTER_ATTRIBUTES FilterAttributes;
ULONG         Size;
 
DEBUGP(DL_TRACE, ("===>FilterAttach: NdisFilterHandle %p\n",
NdisFilterHandle));
do
{
ASSERT(FilterDriverContext == (NDIS_HANDLE)FilterDriverObject);
if (FilterDriverContext != (NDIS_HANDLE)FilterDriverObject)
{
Status = NDIS_STATUS_INVALID_PARAMETER;
break;
}
 
 
if (AttachParameters->MiniportMediaType != NdisMedium802_3)
{
DEBUGP(DL_ERROR, ("MSFilter: Doesn't support media type other than
NdisMedium802_3.\n"));
 
 
Status = NDIS_STATUS_INVALID_PARAMETER;
break;
}
 
 
Size = sizeof(MS_FILTER) +
AttachParameters->FilterModuleGuidName->Length +
AttachParameters->BaseMiniportInstanceName->Length +
AttachParameters->BaseMiniportName->Length;
 
 
pFilter = (PMS_FILTER)FILTER_ALLOC_MEM(NdisFilterHandle, Size);
if (pFilter == NULL)
{
DEBUGP(DL_WARN, ("MSFilter: Failed to allocate context
structure.\n"));
Status = NDIS_STATUS_RESOURCES;
break;
}
 
 
NdisZeroMemory(pFilter, sizeof(MS_FILTER));
 
 
pFilter->FilterModuleName.Length =
pFilter->FilterModuleName.MaximumLength =
AttachParameters->FilterModuleGuidName->Length;
pFilter->FilterModuleName.Buffer = (PWSTR)((PUCHAR)pFilter +
sizeof(MS_FILTER));
NdisMoveMemory(pFilter->FilterModuleName.Buffer,
AttachParameters->FilterModuleGuidName->Buffer,
pFilter->FilterModuleName.Length);
 
 
 
 
 
pFilter->MiniportFriendlyName.Length =
pFilter->MiniportFriendlyName.MaximumLength =
AttachParameters->BaseMiniportInstanceName->Length;
pFilter->MiniportFriendlyName.Buffer =
(PWSTR)((PUCHAR)pFilter->FilterModuleName.Buffer +
pFilter->FilterModuleName.Length);
NdisMoveMemory(pFilter->MiniportFriendlyName.Buffer,
AttachParameters->BaseMiniportInstanceName->Buffer,
pFilter->MiniportFriendlyName.Length);
 
 
 
pFilter->MiniportName.Length = pFilter->MiniportName.MaximumLength =
AttachParameters->BaseMiniportName->Length;
pFilter->MiniportName.Buffer =
(PWSTR)((PUCHAR)pFilter->MiniportFriendlyName.Buffer +
 
 
pFilter->MiniportFriendlyName.Length);
NdisMoveMemory(pFilter->MiniportName.Buffer,
AttachParameters->BaseMiniportName->Buffer,
pFilter->MiniportName.Length);
 
 
pFilter->MiniportIfIndex = AttachParameters->BaseMiniportIfIndex;
//
// The filter should intialize NoTrackReceives and NoTrackSends properly,
for this
// driver, since its default characteristic has both send and receive
handler, they
// are initiazed to FALSE.
//
pFilter->TrackReceives = TRUE;
pFilter->TrackSends = TRUE;
pFilter->FilterHandle = NdisFilterHandle;
 
 
 
NdisZeroMemory(&FilterAttributes, sizeof(NDIS_FILTER_ATTRIBUTES));
FilterAttributes.Header.Revision = NDIS_FILTER_ATTRIBUTES_REVISION_1;
FilterAttributes.Header.Size = sizeof(NDIS_FILTER_ATTRIBUTES);
FilterAttributes.Header.Type = NDIS_OBJECT_TYPE_FILTER_ATTRIBUTES;
FilterAttributes.Flags = 0;
Status = NdisFSetAttributes(NdisFilterHandle,
pFilter,
&FilterAttributes);
if (Status != NDIS_STATUS_SUCCESS)
{
DEBUGP(DL_WARN, ("MSFilter: Failed to set attributes.\n"));
break;
}
 
 
pFilter->State = FilterPaused;
 
 
FILTER_ACQUIRE_LOCK(&FilterListLock, FALSE);
InsertHeadList(&FilterModuleList, &pFilter->FilterModuleLink);
FILTER_RELEASE_LOCK(&FilterListLock, FALSE);
 
 
}
while (FALSE);
 
 
if (Status != NDIS_STATUS_SUCCESS)
{
if (pFilter != NULL)
{
FILTER_FREE_MEM(pFilter);
}
}
  
 
 
DEBUGP(DL_TRACE, ("<===FilterAttach:
  
 
 
Status %x\n", Status));
  
return Status;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
VOID
FilterDetach(
IN NDIS_HANDLE  FilterModuleContext
)
{
  
PMS_FILTER
PFL_NDIS_FILTER_LIST
PLIST_ENTRY
  
pFilter = (PMS_FILTER)FilterModuleContext;
pEntry;
pLink;
  
 
 
 
DEBUGP(DL_TRACE, ("===>FilterDetach:
  
 
 
 
FilterInstance %p\n",
  
FilterModuleContext));
 
 
 
//
// Filter must be in paused state
//
FILTER_ASSERT(pFilter->State == FilterPaused);
 
 
 
//
// Don't come up anything that would prevent the filter from detaching
//
 
 
//
// Free filter instance name if allocated.
//
if (pFilter->FilterName.Buffer != NULL)
{
FILTER_FREE_MEM(pFilter->FilterName.Buffer);
}
 
 
 
FILTER_ACQUIRE_LOCK(&FilterListLock, FALSE);
RemoveEntryList(&pFilter->FilterModuleLink);
FILTER_RELEASE_LOCK(&FilterListLock, FALSE);
 
 
 
//
// Free the memory allocated
FILTER_FREE_MEM(pFilter);
 
 
//
// Alway return success
//
DEBUGP(DL_TRACE, ("<===FilterDetach Successfully\n"));
 
 
return;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
NDIS_STATUS
FilterRestart(
IN NDIS_HANDLE           FilterModuleContext,
IN PNDIS_FILTER_RESTART_PARAMETERS RestartParameters
)
{
NDIS_STATUS  Status;
PMS_FILTER   pFilter = (PMS_FILTER)FilterModuleContext; // BUGBUG, the cast
may be wrong
NDIS_HANDLE  ConfigurationHandle = NULL;
 
 
 
PNDIS_RESTART_GENERAL_ATTRIBUTES NdisGeneralAttributes;
PNDIS_RESTART_ATTRIBUTES    NdisRestartAttributes;
NDIS_CONFIGURATION_OBJECT    ConfigObject;
  
 
 
DEBUGP(DL_TRACE, ("===>FilterRestart:
  
 
 
FilterModuleContext %p\n",
  
FilterModuleContext));
 
 
FILTER_ASSERT(pFilter->State == FilterPaused);
 
 
ConfigObject.Header.Type = NDIS_OBJECT_TYPE_CONFIGURATION_OBJECT;
ConfigObject.Header.Revision = NDIS_CONFIGURATION_OBJECT_REVISION_1;
ConfigObject.Header.Size = sizeof(NDIS_CONFIGURATION_OBJECT);
ConfigObject.NdisHandle = FilterDriverHandle;
ConfigObject.Flags = 0;
 
 
Status = NdisOpenConfigurationEx(&ConfigObject, &ConfigurationHandle);
if (Status != NDIS_STATUS_SUCCESS)
{
//
// Filter driver can choose to fail the restart if it cannot open the
configuration
//
 
 
#if 0
//
// The code is here just to demonstrate how to call NDIS to write an eventlog.
If drivers need to write
// an event log.
//
  
PWCHAR
  
ErrorString = L"NdisMon";
  
 
 
DEBUGP(DL_WARN, ("FilterRestart: Cannot open configuration.\n"));
NdisWriteEventLogEntry(FilterDriverObject,
EVENT_NDIS_DRIVER_FAILURE,
0,
1,
&ErrorString,
sizeof(Status),
&Status);
#endif
 
 
}
 
 
 
if (Status == NDIS_STATUS_SUCCESS)
{
NdisCloseConfiguration(ConfigurationHandle);
}
 
 
NdisRestartAttributes = RestartParameters->RestartAttributes;
 
 
//
// If NdisRestartAttributes is not NULL, then miniport can modify generic
attributes and add
// new media specific info attributes at the end. Otherwise, NDIS restarts the
miniport because
// of other reason, miniport should not try to modify/add attributes
//
if (NdisRestartAttributes != NULL)
{
PNDIS_RESTART_ATTRIBUTES NextAttributes;
 
 
ASSERT(NdisRestartAttributes->Oid ==
OID_GEN_MINIPORT_RESTART_ATTRIBUTES);
 
 
NdisGeneralAttributes =
(PNDIS_RESTART_GENERAL_ATTRIBUTES)NdisRestartAttributes->Data;
 
 
//
// Check to see if we need to change any attributes, for example, the driver
can change the current
// MAC address here. Or the driver can add media specific info attributes.
//
NdisGeneralAttributes->LookaheadSize = 128;
 
 
//
// Check the next attributes to see whether the filter need to modify
//
NextAttributes = NdisRestartAttributes->Next;
 
 
while (NextAttributes != NULL)
{
//
// If somehow the filter needs to change a attributes which requires
more space then
// the current attributes:
// 1. Remove the attribute from the Attributes list:
// TempAttributes = NextAttributes;
// NextAttributes = NextAttributes->Next;
// 2. Free the memory for the current attributes:
NdisFreeMemory(TempAttributes, 0 , 0);
// 3. Dynamically allocate the memory for the new attributes by calling
// NdisAllocateMemoryWithTagPriority:
// NewAttributes = NdisAllocateMemoryWithTagPriority(Handle, size,
Priority);
// 4. Fill in the new attribute
// 5. NewAttributes->Next = NextAttributes;
// 6. NextAttributes = NewAttributes; // Just to make the next statement
works.
//
NextAttributes = NextAttributes->Next;
}
 
//
 
}
 
 
//
// If everything is OK, set the filter in running state
// If it get preempted, it doesn't matter
//
pFilter->State = FilterRunning; // when successful
 
 
 
Status = NDIS_STATUS_SUCCESS;
 
 
if (Status != NDIS_STATUS_SUCCESS)
{
pFilter->State = FilterPaused;
}
 
 
 
DEBUGP(DL_TRACE, ("<===FilterRestart: FilterModuleContext %p, Status %x\n",
FilterModuleContext, Status));
return Status;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
NDIS_STATUS
FilterPause(
IN NDIS_HANDLE           FilterModuleContext,
IN PNDIS_FILTER_PAUSE_PARAMETERS PauseParameters
)
{
PMS_FILTER     pFilter = (PMS_FILTER)(FilterModuleContext);
NDIS_STATUS    Status;
 
 
UNREFERENCED_PARAMETER(PauseParameters);
 
 
DEBUGP(DL_TRACE, ("===>NDISMON FilterPause: FilterInstance %p\n",
FilterModuleContext));
 
 
//
// Set the flag that the filter is going to pause
//
FILTER_ASSERT(pFilter->State == FilterRunning);
 
 
FILTER_ACQUIRE_LOCK(&pFilter->Lock, FALSE);
pFilter->State = FilterPausing;
FILTER_RELEASE_LOCK(&pFilter->Lock, FALSE);
 
 
 
Status = NDIS_STATUS_SUCCESS;
pFilter->State = FilterPaused;
 
 
DEBUGP(DL_TRACE, ("<===FilterPause: Status %x\n", Status));
return Status;
}
1
2
3
Class       = NetService
  
ClassGUID      = {4D36E974‐E325‐11CE‐BFC1‐08002BE10318}
1
2
3
4
5
[Install]
AddReg=Inst_Ndi
Characteristics=0x40000
NetCfgInstanceId="{5cbf81bd‐5055‐47cd‐9055‐a76b2b4e3697}"
Copyfiles = NdisMon.copyfiles.sys
1
2
3
4
5
[Install]
AddReg=Inst_Ndi
Characteristics=0x40000
NetCfgInstanceId="{5cbf81bd‐5055‐47cd‐9055‐a76b2b4e3697}"
Copyfiles = NdisMon.copyfiles.sys
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
[Install]
AddReg=Inst_Ndi
Characteristics=0x40000
NetCfgInstanceId="{5cbf81bd‐5055‐47cd‐9055‐a76b2b4e3697}"
Copyfiles = NdisMon.copyfiles.sys
[Inst_Ndi]
HKR, Ndi,Service,,"NdisMon"
HKR, Ndi,CoServices,0x00010000,"NdisMon"
HKR, Ndi,HelpText,,%NdisMon_HelpText%
HKR, Ndi,FilterClass,, compression
HKR, Ndi,FilterType,0x00010001,0x00000002
HKR, Ndi\Interfaces,UpperRange,,"noupper"
HKR, Ndi\Interfaces,LowerRange,,"nolower"
HKR, Ndi\Interfaces, FilterMediaTypes,,"ethernet"
HKR, Ndi,FilterRunType, 0x00010001, 1

[培训]内核驱动高级班，冲击BAT一流互联网大厂工作，每周日13:00-18:00直播授课

上传的附件：
收藏
免费 ・7
支持
分享
赞赏记录
参与人
雪币
留言
时间
Youlor
感谢你的贡献，论坛因你而更加精彩！
2024-9-2 02:18
伟叔叔
为你点赞！
2024-6-27 03:36
心游尘世外
为你点赞~
2024-5-31 07:29
QinBeast
为你点赞~
2024-5-31 07:20
飘零丶
为你点赞~
2024-5-31 01:53
shinratensei
为你点赞~
2024-5-31 01:38
PLEBFE
为你点赞~
2023-3-5 04:12
最新回复 (25)
hrpirip
雪    币： 55
活跃值： (531)
能力值： ( LV6，RANK：80 )
在线值：
发帖
回帖
粉丝
私信
2 楼
thx，很好。
2014-1-16 17:41
0
licthday
雪    币： 75
活跃值： (218)
能力值： ( LV3，RANK：30 )
在线值：
发帖
回帖
粉丝
私信
3 楼
Tks，看看有没有什么启发
2014-1-16 19:22
0
yvqvan
雪    币： 121
活跃值： (121)
能力值： ( LV2，RANK：10 )
在线值：
发帖
回帖
粉丝
私信
4 楼
貌似MSDN的翻译版
2014-1-16 19:23
0
狗毛大圣
雪    币： 421
活跃值： (12)
能力值： ( LV2，RANK：10 )
在线值：
发帖
回帖
粉丝
私信
5 楼
谢谢楼主 新年快乐!
2014-1-16 19:54
0
LiXMX
雪    币： 2155
活跃值： (29)
能力值： ( LV3，RANK：20 )
在线值：
发帖
回帖
粉丝
私信
6 楼
很好，是中文的，适合我等文盲阅读。。。
2014-1-16 20:24
0
tforever
雪    币： 290
活跃值： (68)
能力值： ( LV2，RANK：10 )
在线值：
发帖
回帖
粉丝
私信
7 楼
谢谢分享i
2014-1-16 20:26
0
vector
雪    币： 549
活跃值： (601)
能力值： ( LV7，RANK：110 )
在线值：
发帖
回帖
粉丝
私信
8 楼
是的，这是我在10年翻译的底稿。
2014-1-16 21:11
0
jaix
雪    币： 42
活跃值： (26)
能力值： ( LV3，RANK：20 )
在线值：
发帖
回帖
粉丝
私信
9 楼
mark 很需要这种翻译版。。。
2014-1-16 21:44
0
AioliaSky
雪    币： 257
活跃值： (67)
能力值： ( LV4，RANK：50 )
在线值：
发帖
回帖
粉丝
私信
10 楼
谢谢分享，支持一下
2014-1-16 22:55
0
jpys
雪    币： 47
活跃值： (10)
能力值： ( LV2，RANK：10 )
在线值：
发帖
回帖
粉丝
私信
11 楼
mark
2014-1-17 08:38
0
fatecaster
雪    币： 135
活跃值： (63)
能力值： ( LV5，RANK：60 )
在线值：
发帖
回帖
粉丝
私信
12 楼
学习。感谢分享。
2014-1-18 12:29
0
wodexinren
雪    币： 74
活跃值： (938)
能力值： ( LV2，RANK：10 )
在线值：
发帖
回帖
粉丝
私信
13 楼
感谢分享
2014-1-21 08:55
0
炸鸡大侠
雪    币： 93
活跃值： (13)
能力值： ( LV2，RANK：10 )
在线值：
发帖
回帖
粉丝
私信
14 楼
感谢分享，最近正好在研究这个
2014-1-21 21:40
0
zgFree
雪    币： 206
活跃值： (1293)
能力值： ( LV2，RANK：10 )
在线值：
发帖
回帖
粉丝
私信
15 楼
很久没有搞ndis的驱动了，下来学习一下
2014-1-22 11:05
0
cjbbug
雪    币： 151
活跃值： (10)
能力值： ( LV2，RANK：10 )
在线值：
发帖
回帖
粉丝
私信
16 楼
感谢！！！
刚研究了spi。真需要这个。
2014-1-24 14:18
0
yhkx
雪    币： 14
活跃值： (13)
能力值： ( LV2，RANK：10 )
在线值：
发帖
回帖
粉丝
私信
17 楼
感谢分享，学习了！
2014-3-14 10:47
0
fnwk
雪    币： 37
活跃值： (10)
能力值： ( LV2，RANK：10 )
在线值：
发帖
回帖
粉丝
私信
18 楼
很棒的资料，翻译的也不错。
2014-4-23 14:36
0
cqzj70
雪    币： 77
活跃值： (53)
能力值： ( LV2，RANK：10 )
在线值：
发帖
回帖
粉丝
私信
19 楼
mark
2014-5-28 22:40
0
IamHuskar
雪    币： 1372
活跃值： (5832)
能力值： ( LV13，RANK：240 )
在线值：
发帖
回帖
粉丝
私信
20 楼
你好，Filter Driver 安装不同于中间层过滤驱动，请问ndis filter和ndis中间层驱动是什么关系呢？
我用vs2013的例子生成的inf双击提示 此inf不允许这么安装，刚接触ndis开发，还望指导
2014-8-6 09:22
0
vector
雪    币： 549
活跃值： (601)
能力值： ( LV7，RANK：110 )
在线值：
发帖
回帖
粉丝
私信
21 楼
至于区别可以自己上调试器看一下驱动栈，就清楚了。呵呵，安装可以看看WDK目录下的bindview工程。
2014-8-6 18:28
0
IamHuskar
雪    币： 1372
活跃值： (5832)
能力值： ( LV13，RANK：240 )
在线值：
发帖
回帖
粉丝
私信
22 楼
看样子是filter挂在中间层的栈上面
2014-8-6 19:00
0
dhvliyike
雪    币： 200
活跃值： (10)
能力值： ( LV2，RANK：10 )
在线值：
发帖
回帖
粉丝
私信
23 楼
10年没来了，想念这里。。看到这么一篇文章，收下了。多谢楼主。
2015-6-11 05:50
0
ielts
雪    币： 965
活跃值： (89)
能力值： ( LV2，RANK：10 )
在线值：
发帖
回帖
粉丝
私信
24 楼
谢谢楼主
2018-9-24 08:35
0
ielts
雪    币： 965
活跃值： (89)
能力值： ( LV2，RANK：10 )
在线值：
发帖
回帖
粉丝
私信
25 楼
谢谢分享i
2018-9-24 20:53
0
游客
登录 | 注册 方可回帖
回帖 表情 雪币赚取及消费
高级回复
返回

账号登录
验证码登录

忘记密码？
没有账号？立即免费注册
我已同意 《看雪服务条款》 《看雪课程免责声明》 《看雪隐私政策》