【转帖】Passthru IM Driver简析

Bertha 。 2022-08-23 15:57 261阅读 0赞

如果你希望对本机发出的数据包进行修改，则涉及如下几个函数：

1)MPSendPackets

由本机协议层调用，用于发送数据包。在这里你可以针对要发送的数据包进行识别及修改，然后再调用NdisSend发送到网络上。此处涉及新内存分配、新Buffer分配以及Buffer与Packet关联NdisChainBufferAtFront。

2)PtSendComplete

当NdisSend成功将数据发出后，NDIS会回调IM的协议层，此时应释放自己分配内存及Buffer，并通过NdisMSendComplete通知真正协议层“您所提交的数据包已发送完成”，以便协议层释放该原始数据包的资源。

如果你希望对本机收到的数据包进行修改，则涉及如下几个函数：

1)PtReceivePacket

2)PtSendComplete

该两个函数与上述两个原理基本相同，只是用于接收数据包。

应该注意的是NDIS中为了提高效率，增加了内存块、缓存描述符、包描述符等实体，巧妙利用了协议分层的特点，每一层均可以在Payload之前很方便地加入自己的包头，而无需拷贝整个Payload，但这也给我们的编程带来了相当大的复杂程度。

具体使用过程中，包描述符可以使用已有的Packet Pool，如果需要组建自己的数据包，则需要分配自己的Buffer Pool，并自己维护Buffer描述符及内存的分配及释放。

附：Passthru阅读笔记

发信人: Immortal1015 (后处理~列拷贝专家), 信区: DriverDev  
标 题: Passthru阅读笔记（一) IMDriver的绑定与卸载过程  
发信站: BBS 水木清华站 (Thu Aug 16 22:34:31 2001)  
  
涂鸦第一篇  
IMDriver的绑定与卸载过程  
一、绑定过程  
首先是Protocol端和下层NIC驱动绑定。NDIS调用PtBindAdapter,  
在PtBindAdapter中调用NdisOpenAdapter，并等待PtOpenAdapterComplete  
执行，在这里用到了NDIS\_EVENT。然后调用NdisIMInitializeDeviceInstanceEx  
来触发Miniport端与上层协议的绑定。  
在调试的时候有一个疑问，居然跟踪不到DriverEntry的调用  
份特死我了。  
PtBindAdapter中有用的参数主要是DeviceName和SystemSpecific1,其中  
DeviceName是下层NIC驱动的服务名，SystemSpecific1可以用来  
读取注册表中相关的值。  
1.调用NdisOpenProtocolConfiguration，参数是SystemSpecific1  
获得ConfigHandle.  
2.调用NdisReadConfiguration(Status,  
&Param,  
ConfigHandle,  
&DeviceStr---"Upperbind",  
NdisParameterString);  
来获得注册表里相关的绑定信息。  
3.再调用NdisReadConfiguration来获得BundleID，其实这段可以不要，  
如果你不需要LBFO的话。  
4.调用NdisOpenAdapter，参数DeviceName来绑定底层NIC驱动。  
5.调用NdisImInitializeDeviceInstanceEx来触发MpInitialize的调用。  
在MpInitialize里面主要做两件事情：  
1.判断介质类型  
2.调用NdisMSetAttributesEx设置一些特性，其中NDIS\_ATTRIBUTE\_DESERILIZE  
和NDIS\_ATTRIBUTE\_INTERMEDIATE\_DRIVER值得注意。  
二、卸载过程  
1.首先注意到，在DriverEntry部分：  
NdisMInitializeWrapper  
|  
|  
NdisIMRegisterLayeredMIniport  
|  
|  
NdisMRegisterUnloadHandler  
这个函数为驱动注册一个卸载函数PtUnload，在PtUnload里面调用  
NdisDeregisterProtocol来取消注册Protocol端  
2.看看相关的Protocol端和Miniport端都做些什么工作。  
Miniport:  
\*\*HaltHandler:这个处理函数当底层NIC已经time out且  
NDIS中止NIC驱动时，或者操作系统关机时被调用。  
Protocol:  
\*\*UnbindAdapterHandler  
\*\*CloseAdapterCompleteHandler  
当点击卸载IM时，ndis首先调用PtUnBindAdapter，在这个  
函数里面:  
1)判断IM Driver 的Miniport Handle是否为空。  
2)如果不为空，则调用NdisImDeInitializeDeviceInstance来出发MpHalt的执行。  
3)如果为空，则调用NdisCloseAdapter，然后等待CloseAdapterCompleteHandler  
的触发。还是用了事件来等待。  
4)释放分配的资源。  
在MpHalt函数里面执行上面的第3，4。  
卸载的流程大体如下：  
PtUnbindAdapter  
| Yes  
MiniportHandle==NULL?------------------  
| |  
|No |  
| |  
NdisImDeInitializeDeviceInstance |  
| |  
| |  
| |  
MpHalt |  
|<------------------------------|  
|  
NdisCloseAdapter  
|  
|  
PtCloseAdapterComplete  
|  
|  
PtUnload  
  
\--  
  
※ 来源:·BBS 水木清华站 smth.org·\[FROM: 166.111.37.73\]

发信人: Immortal1015 (后处理~列拷贝专家), 信区: DriverDev  
标 题: Passthru阅读笔记(二) IP地址的获得  
发信站: BBS 水木清华站 (Sun Sep 2 15:40:40 2001)  
  
呵呵，不好意思。前面说过要分析一下安装过程，还是  
先写点小东西吧。  
  
在IMD里面如何获得网卡所绑定的TCP/IP协议设置的IP地址？  
2KDDK文档的Network Reference Part 2 ch2.1  
中列出了一堆的oid，其中一个是OID\_GEN\_NETWORK\_LAYER\_ADDRESSES  
看看它的说明：  
This OID notifies underlying miniport and other layered drivers about the l  
ist of network-layer addresses that are associated with bound instances. A b  
ound instance is the binding between the calling transport and a driver set  
up by a call to NdisOpenAdapter. Transports use TRANSPORT\_ADDRESS and TA\_ADD  
RESS structures to notify underlying miniport and other layered drivers abou  
t the list of network-layer addresses.  
也就是说，协议栈会向它所绑定的NIC Miniport通知自己的网络地址的信息。  
那么，在passthru miniport端的SetInformationHandler 就会被触发，我们  
可以等到PtRequestComplete的时候来获得网卡的ip地址。  
  
正好，winxp 2462 ddk中的例子e100bex提供了一段代码，大家可以去看看。  
下面是我写的代码：  
NETWORK\_ADDRESS\_LIST UNALIGNED \* pAddrList = NULL;  
NETWORK\_ADDRESS UNALIGNED \* pAddr = NULL;  
NETWORK\_ADDRESS\_IP UNALIGNED \* pIpAddr= NULL;  
ULONG Size;  
ULONG iplong;  
if(NdisRequest->DATA.SET\_INFORMATION.Oid ==  
OID\_GEN\_NETWORK\_LAYER\_ADDRESSES)  
\{  
pAddrList = (NETWORK\_ADDRESS\_LIST UNALIGNED \*)NdisRequest->DATA.SET\_INFO  
RMATION.InformationBuffer;  
if (pAddrList->AddressCount <= 0)  
\{  
return;  
\}  
pAddr = (NETWORK\_ADDRESS UNALIGNED \*)&pAddrList->Address\[0\];  
if (pAddr->AddressType != NDIS\_PROTOCOL\_ID\_TCP\_IP)  
\{  
return;  
\}  
pIpAddr = (NETWORK\_ADDRESS\_IP UNALIGNED \*)&pAddr->Address\[0\];  
Size = sizeof(pIpAddr->in\_addr);  
iplong = pIpAddr->in\_addr;  
\}  
  
  
\--  
  
※ 来源:·BBS 水木清华站 smth.org·\[FROM: 166.111.37.73\]

发信人: Immortal1015 (后处理~列拷贝专家), 信区: DriverDev  
标 题: Passthru阅读笔记(三) 拨号网络  
发信站: BBS 水木清华站 (Wed Oct 3 17:23:44 2001)  
  
呵呵，这个问题搞了我好长时间，就因为一个低级错误。  
其实这个也不算新鲜的了，相信有不少人知道。  
Passthru怎么和拨号网络绑定呢，首先看一下这个图：  
  
TCPIP IPX/SPX NBF  
| | |  
NDISWAN INTERMEDIATE DRIVER  
|  
WAN miniport  
其中，协议层和NDISWAN IMD之间是ndis，而NDISWAN IMD  
和WAN miniport之间的通讯是通过ndis miniport 进行的。  
在ddk network dirver Part 2, ch8, 8.3中有很详细的讲解。  
  
看看passthru如何和拨号网络绑定：  
1. 修改inf。netsf.inf文件中有这么一行：  
HKR, Ndi/Interfaces, FilterMediaTypes,  
, "ethernet, tokenring, fddi"  
其中ethernet,tokenring,fddi指定了要绑定的介质类型。  
把这句话改为：ethernet, tokenring, fddi, wan  
2. passthru.c里面定义了  
NDIS\_MEDIUM MediumArray\[3\]=NdisMedium802\_3,  
NdisMedium802\_5,NdisMediumFddi  
现在需要加上NdisMediumWan.  
3. 在miniport.c的MpInitialize函数的开头：  
NDIS\_MEDIUM medium;  
if(pAdapt->Medium ==NdisMediumWan)  
medium = NdisMedium802\_3;  
for (i = 0; i < MediumArraySize; i++)  
\{  
if (MediumArray\[i\] == medium)  
\{  
\*SelectedMediumIndex = i;  
break;  
\}  
\}  
ok,就这些。  
  
  
  
  
  
  
  
  
  
\--  
  
※ 来源:·BBS 水木清华站 smth.org·\[FROM: 166.111.37.73\]