监听以太网(二) Packet32包说明续
Article last modified on 2002-9-17
The information in this article applies to:
--Microsoft Windwos NTx
--- Microsoft Windwos 9x
--WinPcap: the Free Packet Capture Architecture for Windows
Packet32包中的函数说明:
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事件等。
(To be continued)
Writen by zhengyun@tomosoft.com
本文档所包含的信息代表了在发布之日,ZhengYun 对所讨论问题的当前看法,Zhengyun 不保证所给信息在发布之日以后的准确性。
本文档仅供参考。对本文档中的信息,Zhengyun 不做任何明示或默示的保证。