监听以太网(四) 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()初始化一块大缓冲区，能够显著地减少系统调用，减少捕获进程在处理器上的影响。
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。

监听以太网(四) Packet32函数SDK相关推荐

监听以太网(一) Packet32包说明
简述监听网络上的所有数据,是一个比较有趣的题目.流传比较广的一些监听程序,它们都使用了一个更加著名的开发包Packet32.比如,ntsniff.EthernetSpy.ntpacket等,还有赫 ...
监听以太网(三) Packet32数据结构说明
Packet32包中的数据结构: 第一个重要的数据结构:_ADAPTER(关于Network Adapter的) typedef struct _ADAPTER { // 一个打开的NPF dri ...
监听以太网(二) Packet32包说明
Packet32包中的函数说明: No.2. PacketOpenAdapter (打开网卡) 根据传入的设备名,打开它. LPADAPTER PacketOpenAdapter( LPTSTR A ...
Oracle监听注册和sqlnet,Oracle监听配置(四)--如何实现静态、动态注册
Oracle监听配置(四)--如何实现静态.动态注册第三节我们已经大概了解什么是静态注册和动态注册,下面我们将通过两个例子来更加深入了解它们之间的区别. 静态注册:当listener使用的是非标准端 ...
python 监听tcp端口_创建TCP监听_创建TCP监听_功能示例_Python SDK示例_SDK 参考_开发指南_负载均衡 - 阿里云...
# encoding=utf-8 import json import sys # 调用AcsClient参数进行身份验证 from aliyunsdkcore.client import AcsCl ...
【Java】监听jframe窗口大小改变函数：addComponentListener
问题描述:主要用于解决Jframe窗口大小变化时,里面的组件的位置也会自适应的移动. 相当于js里面的窗口大小改变监听函数: window.onresize = function(){//js脚本接口 ...
Vue钩子函数之钩子事件hookEvent,监听组件
在Vue当中,hooks可以作为一种event,在Vue的源码当中,称之为hookEvent. 在Vue组件中,可以用过$on,$once去监听所有的生命周期钩子函数,如监听组件的updated钩子函 ...
nginx监听事件流程
在前面的几篇文章中已经分析了master进程.work进程的初始化流程.但一直没有分析监听socket的创建流程,nginx服务器只有在创建socket, 绑定socet,监听socket执行完成后, ...
java swing事件监听_Java swing（awt）：事件监听机制的实现原理+简单示例
(1)实现原理事件监听机制的实现: 参考图:事件模型_ActionEvent 为了节省资源,系统无法对某个事件进行实时的监听.故实现的机制是当发生某个事件后,处理代码将被自动运行,类似钩子一般.(回 ...

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

监听以太网(四) Packet32函数SDK相关推荐

最新文章

热门文章