PACKET32 开发包

素颜马尾好姑娘i 2022-01-10 13:39 191阅读 0赞

**1.概述**

监听网络上 的所有数据，是一个比较有趣的题目。流传比较广的一些监听程序，它们都使用了一个更加著名的开发包 Packet32 。比如， **ntsniff、** **hernetSpy** 、 **ntpacket** 等，还有赫赫有名的 **WinPcap** 。应用程序通过它可以设置网卡的工作模式，直接在网卡上读写数据，等等。 <?xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" />

一般使用的 Packet32 的实现版本，是微软的 Packet32.c 和 Packet32.h 。这个版本写得比较简单

**2.**

**Packet32包的内容**

Packet 驱动： Oemsetup.inf 安装信息文件、 Packet.sys 系统文件，在利用 Packet32 包开发网络监控程序前，需要用这两个文件安装 Packet 驱动。 Packet32 程序开发库： Packet32.lib 静态链接库、  Packet32.dll 动态链接库，用户可以通过调用库中的函数直接对网卡进行操作。

**3.Packet32包中的函数说明:**

###  (1)PacketGetAdapterNames(从注册表中读取网卡名) ###

得到现有的网络适配器的列表和它们的描述。

BOOLEAN PacketGetAdapterNames(

PTSTR pStr,

PULONG BufferSize

)；

#### Parameters： ####

*pStr:*

\[in , out\]  一块用户负责分配的缓冲区，将把适配器的名字填充进去。

*BufferSize:*

\[in\] pStr 这块缓冲区的大小。

#### Return Values： ####

如果查询成功，返回一个非零值。

#### Usage: ####

\[C/C++\]

**C/C++ Usage Sample**

**char AdapterNamea\[8192\];**

**ULONG AdapterLength;**

**PacketGetAdapterNames(AdapterName,&AdapterLength);**

通常，这都是与网卡通信时要调用的第一个函数。它返回系统上安装了的网卡的名字。在每个网卡的名字后面， pStr 中还有一个与之相应的描述。

由于结果都是通过查询注册表得到的，所以 WindowsNTx 和 Windows9X/Me 下得到的字符串编码是不同的。 Windows9X 下用 ASCII 编码存储，而 WindowsNTx 则是 Unicode 。

如果是在 Windows9X 下，调用完 PacketGetAdapterNames 后，得到的 pStr 将是这样的：

\-  一串用 "\\0" 分隔的 ASCII 字符串，每一个都是一个网卡的名字；

\-  两个 "\\0" ；

\-  一串用 "\\0" 分隔的 ASCII 字符串，每一个都是一个网卡的描述；顺序是和网卡名字一样的；

\-  两个 "\\0" ；

如果是在 WindowsNTx 下，调用完 PacketGetAdapterNames 后，得到的 pStr 将是这样的：

\-  一串用一个 Unicode 的 "\\0" 分隔的 Unicode 字符串，每一个都是一个网卡的名字；

\-  两个 Unicode 的 "\\0" ；

\-  一串用 ASCII 的 "\\0" 分隔的 ASCII 字符串，每一个都是一个网卡的描述；顺序是和网卡名字一样的；

\-  两个 ASCII 的 "\\0" ；

这个函数的操作大致为：

网卡的注册表项是：

**HKEY\_LOCAL\_MACHINE\\**

**SYSTEM\\**

**CurrentControlSet\\**

**Control\\**

**Class\\**

**\{4D36E972-E325-11CE-BFC1-08002BE10318\}**

先打开这个键值；

再枚举下面的每一项，依次读取参数：

对子项 \\Linkage\\UpperBind 参数，核对是否等于 ” NdisWan” ，如果不是，就跳过去；

如果是 ” NdisWan” ，则读取子项 \\Linkage\\Export ，这就是网卡的名字。

如果前面的查询有网卡记录，那么执行下面这个循环：

将调用 **PacketOpenAdapter** 打开每个网卡；

其中将调用 **PacketRequest**(adapter,FALSE,OidData) 来得到网卡的描述；

具体方法是这样， OidData 是一个 PACKET\_OID\_DATA 结构，我们事先设置它的 Oid 成员为 OID\_GEN\_VENDOR\_DESCRIPTION ，然后调用 PacketRequest 把这个 OID 发送给网卡 driver ，就可以从 OidData->Data 中拿到网卡的描述了。

最后调用 **PacketCloseAdapter** 关闭适配器。

如果前面没有查询到网卡记录，那么执行我们将根据 TCP/IP Binding 来查找网卡：

先打开这个键值；

**HKEY\_LOCAL\_MACHINE\\**

**SYSTEM\\**

**CurrentControlSet\\**

**Services\\**

**Tcpip\\**

**Linkage**

它的 Bind 参数设置的就是现在系统上绑定的网卡的名字。

得到名字之后，同上调用 PacketOpenAdapter 和 PacketRequest 方法向网卡查询它的描述。

**(To be continued)**

Writen by [zhengyun@tomosoft.com][zhengyun_tomosoft.com]

本文档所包含的信息代表了在发布之日， ZhengYun  对所讨论问题的当前看法， Zhengyun  不保证所给信息在发布之日以后的准确性。

本文档仅供参考。对本文档中的信息， Zhengyun  不做任何明示或默示的保证。

\-----------------------------------------------------------------------------------

**Packet32.dll的内容：**  
 Packet驱动：Oemsetup.inf安装信息文件、Packet.sys系统文件，在利用Packet32包开发网络监控程序前，需要用这两个文件安装Packet驱动。Packet32程序开发库：Packet32.lib静态链接库，Packet32.dll动态链接库，用户可以通过调用库中的函数直接对网卡进行操作。

Packet32包中的函数说明:  
No.1. PacketGetAdapterNames  
(从注册表中读取网卡名) 得到现有的网络适配器的列表和它们的描述。  
BOOLEAN PacketGetAdapterNames( PTSTR pStr, PULONG BufferSize )；  
Parameters： pStr: \[in , out\] 一块用户负责分配的缓冲区，将把适配器的名字填充进去。  
BufferSize: \[in\] pStr这块缓冲区的大小。  
Return Values：如果查询成功，返回一个非零值。  
Usage: \[C/C++\]  
C/C++ Usage Sample  
char AdapterNamea\[8192\];  
ULONG AdapterLength;  
PacketGetAdapterNames(AdapterName,&AdapterLength);  
Remarks: 通常，这都是与网卡通信时要调用的第一个函数。它返回系统上安装了的网卡的名字。在每个网卡的名字后面，pStr中还有一个与之相应的描述。 由于结果都是通过查询注册表得到的，所以WindowsNTx和Windows9X/Me下得到的字符串编码是不同的。Windows9X下用ASCII编码存储，而WindowsNTx则是Unicode。 如果是在Windows9X下，调用完PacketGetAdapterNames后，得到的pStr将是这样的：  
\- 一串用"\\\\0"分隔的ASCII字符串，每一个都是一个网卡的名字；  
\- 两个"\\\\0"；  
\- 一串用"\\\\0"分隔的ASCII字符串，每一个都是一个网卡的描述；顺序是和网卡名字一样的；  
\- 两个"\\\\0"；

如果是在WindowsNTx下，调用完PacketGetAdapterNames后，得到的pStr将是这样的：  
\- 一串用一个Unicode的"\\\\0"分隔的Unicode字符串，每一个都是一个网卡的名字；  
\- 两个Unicode的"\\\\0"；  
\- 一串用ASCII的"\\\\0"分隔的ASCII字符串，每一个都是一个网卡的描述；顺序是和网卡名字一样的；  
\- 两个ASCII的"\\\\0"；

这个函数的操作大致为：  
网卡的注册表项是：  
HKEY\_LOCAL\_MACHINE\\\\SYSTEM\\\\CurrentControlSet\\\\Control\\\\Class\\\\\{4D36E972-E325-11CE-BFC1-08002BE10318\}  
先打开这个键值； 再枚举下面的每一项，依次读取参数： 对子项\\\\Linkage\\\\UpperBind参数，核对是否等于“ NdisWan”，如果不是，就跳过去； 如果是“NdisWan”，则读取子项\\\\Linkage\\\\Export，这就是网卡的名字。 如果前面的查询有网卡记录，那么执行下面这个循环： 将调用PacketOpenAdapter打开每个网卡； 其中将调用PacketRequest(adapter,FALSE,OidData)来得到网卡的描述； 具体方法是这样，OidData是一个PACKET\_OID\_DATA结构，我们事先设置它的Oid成员为OID\_GEN\_VENDOR\_DESCRIPTION，然后调用PacketRequest把这个OID发送给网卡driver，就可以从OidData->Data中拿到网卡的描述了。 最后调用PacketCloseAdapter关闭适配器。 如果前面没有查询到网卡记录，那么执行我们将根据TCP/IP Binding来查找网卡： 先打开这个键值； HKEY\_LOCAL\_MACHINE\\\\ SYSTEM\\\\ CurrentControlSet\\\\ Services\\\\ Tcpip\\\\ Linkage 它的Bind参数设置的就是现在系统上绑定的网卡的名字。 得到名字之后，同上调用PacketOpenAdapter和PacketRequest方法向网卡查询它的描述。

No.2. PacketOpenAdapter (打开网卡) 根据传入的设备名，打开它。  
LPADAPTER PacketOpenAdapter(LPTSTR AdapterName);  
Parameters： AdapterName: \[in\] 要打开的设备的名字。  
Return Values： 如果打开成功，返回一个指针，它指向一个正确初始化了的ADAPTER Object。 否则，返回NULL。 Usage: \[C/C++\]  
C/C++ Usage Sample  
LPADAPTER adapter;  
adapter = PacketOpenAdapter(pStr+rewind);  
Remarks: 这个函数尝试加载并启动packet driver，这样，管理driver对于应用程序来说就十分的透明了。  
Windows9X版本的NPF driver用的是ASCII编码，  
而WindowsNTx用的是Unicode编码。所以提请注意这个输入参数AdapterName，  
在Windows9X下，必须是正确的编码格式！  
在WindowsNTx下，这个函数能够监测到ASCII编码，并在送给driver 之前先转换为Unicode编码。 这个函数的操作大致为： 首先调用OpenSCManager，以Administrators的身份连接Service Control Manager，权限是SC\_MANAGER\_ALL\_ACCESS。这也说明，使用Packet.dll你必须是本机管理员组成员。 如果可以连接SCM，检查NPF注册表项是否存在。如果存在，说明driver已经安装了，就不需要我们调用PacketInstallDriver了。  
NPF注册表项： HKEY\_LOCAL\_MACHINE\\\\SYSTEM\\\\CurrentControlSet\\\\Services\\\\NPF  
如果不存在此键，则调用PacketInstallDriver安装当前路径下的driver：npf.sys。 如果这次PacketInstallDriver安装也失败了，就到系统路径下查找并安装这个驱动。 如果以上操作都成功的话，调用OpenService打开NPF服务。如果服务存在的话，就调用QueryServiceStatus查询当前服务状态。这就是我们的driver的状态。 如果这个服务没有启动，就调用StartService启动之。 确认服务启动之后，检查AdapterName是否是ASCII编码，是的话，就转换为Unicode。 由于一般输入参数AdapterNAme类似于这样： \\\\Device\\\\NPF\_\{A67CEC3B-C099-47E0-B096-480B01FAF348\}  
所以，我们会重新组织一个设备名SymbolicLink： “Packet\_”的前缀 + AdapterName\[8\] 也就是：  
\\\\\\\\.\\\\Packet\_NPF\_\{A67CEC3B-C099-47E0-B096-480B01FAF348\}  
先尝试着CreateFile函数能不能马上用这个SymbolicLink名字打开设备。 如果可以，就调用PacketSetReadEvt函数打开一个open事件等。 否则，调用DefineDosDevice定义一个新的MS-DOS设备： 名字类似于” Packet\_NPF\_\{A67CEC3B-C099-47E0-B096-480B01FAF348\}”。 通过这个DOS设备名，我们的应用层程序才能向驱动发出请求。 接着，调用CreateFile函数来建立并打开一个联系设备的文件句柄(GENERIC\_WRITE| GENERIC\_READ，OPEN\_EXISTING)。 之后，调用PacketSetReadEvt函数打开一个open事件等。

Packet32包中的数据结构:  
第一个重要的数据结构：**\_ADAPTER**(关于Network Adapter的)  
typedef struct \_ADAPTER \{  
// 一个打开的NPF driver实例的句柄:  
HANDLE hFile;  
// 当前打开的网卡的名字:  
CHAR SymbolicLink\[MAX\_LINK\_NAME\_LENGTH\];  
// 在这块Adapter上，一个数据包被写的次数:  
int NumWrites;  
// 这块Adapter上的read操作的通知事件。它可以被传递给标准Win32函数(如WaitForSingleObject或者WaitForMultipleObjects)，这样可以等待到driver的缓冲区内有数据到来。在同时等待几个事件的GUI程序中，它特别有用。在Windows2000/XP中，函数PacketSetMinToCopy()可以用来设置内核缓冲区中激发本事件的最小数据大小:  
HANDLE ReadEvent;  
// 设置一个时间，到时候，即使没有捕获任何包，read操作也会被释放，ReadEvent也会被触发:  
UINT ReadTimeOut;  
\} ADAPTER, \*LPADAPTER;

第二个重要的数据结构：**\_PACKET**(关于Packet的)  
typedef struct \_PACKET \{  
// 向后兼容用的:   
HANDLE hEvent;  
// 向后兼容用的:   
OVERLAPPED OverLapped;  
// 存放Packets的缓冲区:   
PVOID Buffer;  
// 缓冲区的大小:   
UINT Length;  
// 当前缓冲区中有效的字节数，如，上一次调用PacketReceivePacket()函数接收到的字节数:   
DWORD ulBytesReceived;  
// 向后兼容用的:   
BOOLEAN bIoComplete  
\} PACKET, \*LPPACKET;

第三个重要的数据结构：\_PACKET\_OID\_DATA (关于OID请求的)  
typedef struct \_PACKET\_OID\_DATA \{  
// OID的code，有效的OID code的定义参见ntddndis.h；比如： // OID\_GEN\_SUPPORTED\_LIST，OID\_GEN\_VENDOR\_DESCRIPTION等:   
ULONG Oid;  
// 成员Data的长度:   
ULONG Length;  
// 存放发送给网卡或者从网卡接收的数据的缓冲区:   
UCHAR Data\[1\];  
\} typedef struct \_PACKET\_OID\_DATA PACKET\_OID\_DATA, \*PPACKET\_OID\_DATA;

其他数据结构：

npf\_if\_addr(网卡的地址)：  
typedef struct npf\_if\_addr \{  
struct sockaddr IPAddress; // IP address.  
struct sockaddr SubnetMask; // Netmask for that address.  
struct sockaddr Broadcast; // Broadcast address.  
\}npf\_if\_addr;

bpf\_hdr(Packet Header)：  
struct bpf\_hdr \{  
// 捕获到的packet的timestamp:  
struct timeval bh\_tstamp;  
// 捕获到的packet的长度:  
UINT bh\_caplen;  
// 原始packet的长度:  
UINT bh\_datalen;  
// bpf header的长度(this struct plus alignment padding):  
USHORT bh\_hdrlen;  
\};

bpf\_insn(一个简单的BPF伪指令): bpf\_insn中包含了一个BPF注册机的简单指令，它被用来发送一个filter程序给driver。  
struct bpf\_insn \{  
// 指令的类型和寻址模式:  
USHORT code;  
// Jump if true:  
UCHAR jt;  
// Jump if false:  
UCHAR jf;  
// 通用的一个字段，有多种目的:  
int k;  
\};

bpf\_program(一个BPF伪汇编程序): 这段程序将被PacketSetBPF()注射入内核，并被应用到每一个进来的Packet。  
struct bpf\_program \{  
// 程序指令数目，如，后面的bpf\_insn结构的数目:  
UINT bf\_len;  
// 指向第一个bpf\_insn结构的指针:  
struct bpf\_insn \*bf\_insns;  
\};

bpf\_stat (本次捕获的统计数据): 这个结构将被Packet.dll用来返回捕获过程中的统计数据。  
struct bpf\_stat \{  
// 从开始捕获起，这个driver从网卡上接收的Packet的数量(包括driver丢失的Packet):  
UINT bs\_recv;  
//从开始捕获起，这个driver丢失的Packet的数量，一般地，包丢失，是因为driver的缓冲区满了，这时driver将扔掉这个包:  
UINT bs\_drop;  
UINT ps\_ifdrop;  
// 通过filter的包的数量:  
UINT bs\_capt;  
\};

dump\_bpf\_hdr(Dump Packet Header):  
struct dump\_bpf\_hdr\{  
// Packet的timestamp:  
struct timeval ts;  
// 捕获到的packet的长度:  
UINT caplen;  
// 原始Packet的长度:  
UINT len; \};

NetType (网络类型): NetType用于PacketGetNetType()，返回当前网卡的类型和速度。  
struct NetType\{  
//当前网卡的MAC:  
UINT LinkType;  
// 网络的速度(bits/s):  
UINT LinkSpeed;  
\};

No.3. PacketSetHwFilter (设置过滤器)

设置一个hardware filter。比如，Filter参数传递NDIS\_PACKET\_TYPE\_PROMISCUOUS，就可以设置网卡为混杂模式。  
BOOLEAN PacketSetHwFilter(  
LPADAPTER AdapterObject, ULONG Filter);

Parameters：  
AdapterObject: \[in\] 指向一个\_ADAPTER结构的指针。

Filter: \[in\] 过滤器的id。

Return Values：如果执行成功，返回一个非零值。

Usage: C/C++ Usage Sample

lpAdapter = PacketOpenAdapter(AdapterList\[Open-1\]);

PacketSetHwFilter(lpAdapter,NDIS\_PACKET\_TYPE\_PROMISCUOUS);

Remarks: 过滤器定义在ntddndis.h中。下面是一些最常用的：

NDIS\_PACKET\_TYPE\_PROMISCUOUS：设置混杂模式。网卡接收每一个Packet；

NDIS\_PACKET\_TYPE\_DIRECTED；

NDIS\_PACKET\_TYPE\_BROADCAST：只接收broadcast packets；

NDIS\_PACKET\_TYPE\_MULTICAST：只接收multicast packets，而且本机网卡是接收组的一个成员；

NDIS\_PACKET\_TYPE\_ALL\_MULTICAST：所有multicast packets都接收；

NDIS\_PACKET\_TYPE\_ALL\_LOCAL：所有local packets。

这个函数的实现是非常简单的：  
首先填充PACKET\_OID\_DATA结构的Oid成员为OID\_GEN\_CURRENT\_PACKET\_FILTER，填充Data成员为既定的Filter，调用PacketRequest向网卡发送OID请求即可。

No.4. PacketSetBuff (设置缓冲区的大小)设置捕获的内核级缓冲区的大小。

BOOLEAN PacketSetBuff(LPADAPTER AdapterObject,int dim);

Parameters：  
AdapterObject:\[in\] 指向一个\_ADAPTER结构的指针。  
dim: \[in\] 缓冲区的大小(单位：字节)。

Return Values：如果执行成功，返回一个TRUE。如果没有足够的内存分配，返回FALSE。

Usage: C/C++ Usage Sample

lpAdapter = PacketOpenAdapter(AdapterList\[Open-1\]);

PacketSetBuff(lpAdapter,512000) ; // 设置driver有512KB字节的缓冲区

Remarks:一旦设定了一个新缓冲区大小，在原来的那块缓冲区中的数据就会被丢弃，包括存在里面的Packets。

注意：内核缓冲区的大小会严重影响到捕获进程的性能。一个适当的缓冲区可以在应用忙时保有数据，从而补偿应用的响应延迟，并在网络活动频繁时做到不丢失Packets。当driver的一个实例被打开时，这个缓冲区的大小被重设为0：开发者应该记得把它设为一个合适的值，比如设为1MB。

本函数调用了DeviceIoControl，给AdapterObject参数的hFile成员指向的NPF driver设备发送pBIOCSETBUFFERSIZE控制码。pBIOCSETBUFFERSIZE是在Packet32.h中定义的：

//< IOCTL code: set kernel buffer size：

\#define pBIOCSETBUFFERSIZE 9592

No.5. PacketSetReadTimeout (设置读操作的超时时间)设置一次读操作返回的超时时间。

BOOLEAN PacketSetReadTimeout(LPADAPTER AdapterObject, int timeout);

Parameters：  
AdapterObject: \[in\] 指向一个\_ADAPTER结构的指针。

timeout: \[in\] 超时时间(单位：毫秒)。

Return Values： 如果执行成功，返回非零值。

Usage: C/C++ Usage Sample

lpAdapter = PacketOpenAdapter(AdapterList\[Open-1\]);

PacketSetReadTimeout(lpAdapter,1000) ; // 设置读操作超时时间1秒

Remarks:在AdapterObject指向的网卡上调用PacketReceivePacket()，到了设定的超时时间，这次调用就会释放，即使没有Packet被捕获到。设置超时时间为0，说明没有超时。这样，如果没有Packet到来的话，PacketReceivePacket()方法永不会返回。设置超时时间为-1，PacketReceivePacket()会立即返回。这个函数也工作在网卡的统计模式下。所以可以用来设置两次统计报告之间的时间间隔。这个函数也是通过DeviceIoControl发送控制码来实现的。

No.6. PacketAllocatePacket 为\_PACKET结构分配内存。

LPPACKET PacketAllocatePacket(void);

Parameters：void  
Return Values： 如果执行成功，返回指向\_PACKET结构的指针。否则，返回NULL。

Usage: C/C++ Usage Sample

LPPACKET lpPacket;  
lpPacket = PacketAllocatePacket() ;

Remarks: 这个函数并不负责为\_PACKET结构的Buffer成员分配空间。这块缓冲区必须由应用程序分配，而且必须调用PacketInitPacket来将这缓冲区和\_PACKET结构关联到一起。

No.7. PacketInitPacket 初始化一个\_PACKET结构，即将packet结构中的buffer设置为传递的buffer指针。

VOID PacketInitPacket(LPPACKET lpPacket, PVOID Buffer, UINT Length);

Parameters：

lpPacket \[in\] 指向一个\_PACKET结构的指针。

Buffer \[in\] 一个指向一块用户分配的缓冲区的指针。捕获的数据将放置于此。

Length \[in\] 缓冲区的大小。这是一个读操作从driver传递到应用的最大数据量。

Return Values：void

Usage: C/C++ Usage Sample

char buffer\[256000\];  
LPPACKET lpPacket;

PacketInitPacket(lpPacket,(char\*)buffer,256000);;

Remarks: Driver能够用一个读操作返回几个Packets，那么一次调用传递给应用程序的packet的数量，就只取决于传递给PacketReceivePacket()的\_PACKET结构的buffer的大小了。因此用PacketInitPacket()初始化一块大缓冲区，能够显著地减少系统调用，减少捕获进程在处理器上的影响。

No.8. PacketReceivePacket (读取数据) 从NPF driver上读取数据（Packets或者统计信息）。

BOOLEAN PacketReceivePacket(LPADAPTER AdapterObject, LPPACKET lpPacket, BOOLEAN Sync);

Parameters：  
AdapterObject: \[in\] 指向一个\_ADAPTER结构的指针。  
lpPacket: \[in , out\] 放数据的\_PACKET结构缓冲区。  
Sync: \[in\] 一个可以忽略的参数，保留它是为了向后兼容。

Return Values：如果执行成功，返回一个非零值。

Usage: C/C++ Usage Sample

LPADAPTER lpAdapter = 0;

LPPACKET lpPacket;

lpAdapter = PacketOpenAdapter(AdapterList\[Open-1\]);

lpPacket = PacketAllocatePacket();

PacketInitPacket(lpPacket,(char\*)buffer,256000);

PacketReceivePacket(lpAdapter,lpPacket,TRUE);

Remarks: 这个函数所接收的数据可以是一组Packets，也可以是网络流量的一个统计数据，依赖于网卡的工作模式。接收到的Packet的数量是可变的。它依赖于几个因素：当前存储在driver缓冲区中的Packet的数目，这些Packet的大小，分配给lpPacket参数的缓冲区的大小。Packet存储在lpPacket结构的buffer缓冲区内，lpPacket->Length指示着复制到缓冲区的数据的大小。它的实现也很简单：先看看AdapterObject->ReadTimeOut是否是-1：如果不是-1，则调用WaitForSingleObject等候AdapterObject->ReadEvent读事件触发，超时时间为AdapterObject->ReadTimeOut的数值。如果AdapterObject->ReadTimeOut为0，则永不超时。如果是-1，就表明读完立即返回。之后，调用ReadFile读取数据。

No.9. PacketGetStats (得到本次捕获的统计数据)得到当前捕获进程的统计信息。

BOOLEAN PacketGetStats(LPADAPTER AdapterObject, struct bpf\_stat \*s);

Parameters：  
AdapterObject: \[in\] 指向一个\_ADAPTER结构的指针。  
s: \[in, out\] bpf\_stat结构，通过它，我们可以知道接收到的包数，丢失的包数等。

Return Values：如果执行成功，返回非零值。

Usage: C/C++ Usage Sample

struct bpf\_stat stat;  
PacketGetStats(lpAdapter,&stat) ;

Remarks:通过这个函数，我们可以知道：从开始捕获起，这个driver从网卡上接收的Packet的数量(包括driver丢失的Packet)；从开始捕获起，这个driver丢失的Packet的数量，一般地，包丢失，是因为driver的缓冲区满了，这时driver将扔掉这个包。具体实现也是调用DeviceIoControl函数向设备发送pBIOCGSTATS控制码，得到一个bpf\_stat结构，然后只把这个结构的bs\_recv和bs\_drop成员返回。

No.10. PacketCloseAdapter 关闭网卡。

VOID PacketCloseAdapter(LPADAPTER lpAdapter);

Parameters：  
lpAdapter: \[in\] 指向一个\_ADAPTER结构的指针。

Remarks: 依次做下面的动作：

关闭lpAdapter->hFile，打开的NPF driver的实例句柄；触发lpAdapter->ReadEvent，并关闭这个句柄；解锁并释放lpAdapter。

**1 WinPCap驱动简介**  
  
WinPCap(Windows Packet Capture)是Windows平台下一个免费，公共的网络访问系统。  
  
开发WinPCap这个项目的目的在于为win32应用程序提供访问网络底层的能力。它提供了以下的各项功能：  
(1) 捕获原始数据报，包括在共享网络上各主机发送/接收的以及相互之间交换的数据报；  
(2) 在数据报发往应用程序之前，按照自定义的规则将某些特殊的数据报过滤掉；  
(3) 在网络上发送原始的数据报；  
(4) 收集网络通信过程中的统计信息。

WinPCap的主要功能在于独立于主机协议(如TCP/IP)而发送和接收原始数据报。也就是说，WinPCap不能阻塞，过滤或控制其他应用程序数据报的发收，它仅仅只是监听共享网络上传送的数据报。因此，它不能用于QoS调度程序或个人防火墙。目前，WinPCap开发的主要对象是Windows NT/2000/XP，这主要是因为在使用WinPCap的用户中只有一小部分是仅使用Windows 95/98/Me，并且MS也已经放弃了对win9x的开发。因此本文相关的程序T-ARP也是面向WinNT/2000/XP用户的。其实WinPCap中的面向9x系统的概念和NT系统的非常相似，只是在某些实现上有点差异，比如说9x只支持ANSI编码，而NT系统则提倡使用Unicode编码。

本文讨论的是packet.dll所提供的各种函数，因为它们完全可以实现本文所希望的各项要求。但是如果你有其他特别的或更高级的要求，WinPCap也提供了另一个动态连接库wpcap.dll。虽然wpcap.dll依靠于packet.dll,但是它却提供了一种更简单，直接，有力的方法来更好的利用编程环境。比如捕获一个数据报，创建一个数据报过滤装置或将监听到的数据报转存到某个文件等，wpcap.dll都会为你提供更加安全的实现方法。

**2 Packet.dll相关数据结构及函数**  
  
本文的目的在于介绍如何利用WinPCap驱动写ARP工具，因此有必要介绍一些相关的数据结构和函数。

首先介绍一些相关的数据结构：  
1. typedef struct \_ADAPTER ADAPTER; //描述一个网络适配器；  
2. typedef struct \_PACKET PACKET; //描述一组网络数据报的结构；  
3. typedef struct NetType NetType; //描述网络类型的数据结构；  
4. typedef struct npf\_if\_addr npf\_if\_addr; //描述一个网络适配器的ip地址；  
5. struct bpf\_hdr; //数据报头部；  
6. struct bpf\_stat; //当前捕获数据报的统计信息。

下面，介绍在packet.dll中定义的函数：  
(1).LPPACKET PacketAllocatePacket(void)  
如果运行成功，返回一个\_PACKET结构的指针，否则返回NULL。成功返回的结果将会传送到PacketReceivePacket()函数，接收来自驱动的网络数据报。

(2).VOID PacketCloseAdapter(LPADAPTER lpAdapter)  
关闭参数中提供的网络适配器，释放相关的ADAPTER结构。

(3).VOID PacketFreePacket(LPPACKET lpPacket)  
释放参数提供的\_PACKET结构。

(4).BOOLEAN PacketGetAdapterNames(LPSTR pStr, PULONG BufferSize)  
返回可以得到的网络适配器列表及描述。

(5).BOOLEAN PacketGetNetInfoEx(LPTSTR AdapterNames, npf\_ip\_addr \*buff, PLONG NEntries)  
返回某个网络适配器的全面地址信息。  
其中npf\_ip\_addr结构包含：IPAddress, SubnetMask, Broadcast  
IPAddress: IP地址  
SubnetMask: 子网掩码  
Broadcast: 广播地址

(6).BOOLEAN PacketGetNetType(LPADAPTER AdapterObject, NetType \*type)  
返回某个网络适配器的MAC类型。  
NetType结构里包含了LinkSpeed(速度）和LinkType(类型）。其中LinkType包含以下几种情况：  
NdisMedium802\_3: Ethernet(802.3)  
NdisMediumWan: WAN  
NdisMedium802\_5: Token Ring(802.5)  
NdisMediumFddi: FDDI  
NdisMediumAtm: ATM  
NdisMediumArcnet878\_2: ARCNET(878.2)

(7).BOOLEAN PacketGetStats(LPADAPTER AdapterObject,struct bpf\_stat \*s)  
返回几个关于当前捕获报告的统计信息。  
其中bpf\_stat结构包含：bs\_recv, bs\_drop, ps\_ifdrop, bs\_capt  
bs\_recv: 从网络适配器开始捕获数据报开始所接收到的所有数据报的数目，包括丢失的数据报；  
bs\_drop: 丢失的数据报数目。在驱动缓冲区已经满时，就会发生数据报丢失的情况。

(8).PCHAR PacketGetVersion()  
返回关于dll的版本信息。

(9).VOID PacketInitPacket(LPPACKET lpPacket, PVOID Buffer, UINT Length)  
初始化一个\_PACKET结构。

(10).LPADAPTER PacketOpetAdapter(LPTSTR AdapterName)  
打开一个网络适配器。

(12).BOOLEAN PacketSendPacket(LPADAPTER AdapterObject,LPPACKET lpPacket, BOOLEAN Sync)  
发送一个或多个数据报的副本。

(13).BOOLEAN PacketSetBuff(LPADAPTER AdapterObject,int dim)  
设置捕获数据报的内核级缓冲区大小。

(14).BOOLEAN PacketSetHwFilter(LPADAPTER AdapterObject,ULONG Filter)  
为接收到的数据报设置硬件过滤规则。  
以下为一些典型的过滤规则：  
NDIS\_PACKET\_TYPE\_PROMISCUOUS: 设置为混杂模式，接收所有流过的数据报；  
NDIS\_PACKET\_TYPE\_DIRECTED: 只有目的地为本地主机网络适配器的数据报才会被接收；  
NDIS\_PACKET\_TYPE\_BROADCAST: 只有广播数据报才会被接收；  
NDIS\_PACKET\_TYPE\_MULTICAST: 只有与本地主机网络适配器相对应的多播数据报才会被接收；  
NDIS\_PACKET\_TYPE\_ALL\_MULTICAST: 所有多播数据报均被接收；  
NDIS\_PACKET\_TYPE\_ALL\_LOCAL: 所有本地数据报均被接收。

(15).BOOLEAN PacketSetNumWrites(LPADAPTER AdapterObject,int nwrites)  
设置调用PacketSendPacket()函数发送一个数据报副本所重复的次数。

(16).BOOLEAN PacketSetReadTimeout(LPADAPTER AdapterObject,int timeout)  
设置在接收到一个数据报后“休息”的时间。

转载于:https://blog.51cto.com/golddzq/282386

[zhengyun_tomosoft.com]: mailto:zhengyun@tomosoft.com