监听以太网(四)Packet32函数SDK

监听以太网(四) Packet32函数SDK

Packet32包中的函数说明:

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：

无 数据挖掘交友

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：

无。 数据挖掘交友

Usage:

C/C++ Usage Sample

数据挖掘研究院

char buffer[256000];

数据挖掘研究院

LPPACKET   lpPacket; 数据挖掘实验室

PacketInitPacket(lpPacket,(char*)buffer,256000);; 数据挖掘实验室

Remarks:

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