windows nt环境下fddi网卡驱动程序设计

rapperhandle，驱动程序保存这个句柄，以利后来调用ndisxxxconfiguration和initialization等函数。  
填写ndisxx_miniport_characteristics属性结构，主要记录ndis版本号和驱动程序支持的miniportxxx函数的入口点，然后调用ndismregisterminiport函数实现驱动程序的整体注册。  
以yhfddi为例所要注册的属性结构的内容大致如下：
ndis_miniport_characteristics  yhfddichar;
(ndis_miniport_characteristics这个结构将在第三章介绍)
yhfddichar.majorndisversion=yhfddi_ndis_major_version;
yhfddichar.minorndisversion=yhfddi_ndis_minor_version;
这两个属性决定驱动程序是ndis的哪个版本所支持，我们所用的是ndis3.0  
yhfddichar.disableinterrupthandler=yhfddidisableinterrupt;
yhfddichar.enableinterrupthandler=yhfddienableinterrupt;
yhfddichar.isrhandle=yhfddiinterruptservice;
yhfddichar.handleinterrupthandler=yhfddihandleinterrupt;
以上四项属性是中断处理所需的上边缘服务函数的入口点（句柄）。fddi网卡驱动程序需要有smt站管理功能，而smt是以中断处理方式进行的，故这四项属性在fddi网卡驱动程序中是很重要的。
yhfddichar.initializehandler=yhfddiinitialize;
此项注册的是驱动程序的初始化函数句柄。
yhfddichar.queryinformationhandler=  yhfddiqueryinformation;
yhfddichar.setinformationhandler=yhfddisetinformation;
这两项注册的是参数查询和设置函数的句柄。
yhfddichar.sendhanler=  yhfddisend;
yhfddichar.transferdatahandler=  yhfdditransferdata;
主要提供数据发送和接收函数句柄。
yhfddichar.resethandler=yhfddireset;
此项注册网卡软硬件重置函数句柄。  
yhfddichar.halthandler=  yhfddihalt;
此项注册网卡驱动程序挂起函数句柄。
yhfddichar.checkforhandler=null;
yhfddichar.reconfigurehandler=null;
这两个上边缘服务函数是fddi网卡驱动程序所不提供的，故置为null。
填好这些结构以后，调用以下函数实现驱动程序的注册：
ndismregisterminiport(
yhfddiwrapperhandle,
&yhfddichar,

sizeof(yhfddichar));
其中yhfddiwrapperhandle是在此之前初始化wrapper调用ndisminitializewrapper所得的句柄。
如果调用ndismregisterminiport不能返回ndis_status_success，必须在退出driverentry之前释放已经分配的资源（如yhfddiwrapperhandle等），故调用
ndisterminatewrapper(yhfddiwrapperhandle,null)。
这样驱动程序没能正确注册，亦不能正常运行。
第四节  网卡驱动程序对象查询与设置
如果ndis的管理实体要查询或设置一个特定的网络对象，它必须提供一个32位的oid。oid的结构如下：  图2.3.0  oid结构图
由上可以看到，oid可分为三大类：
所有ndis驱动程序都有的一般对象；  
特定介质的对象；  
特殊的与具体实现相关的对象（如多目地址表的长度）。  
一般的和特定介质的oid被记录在windows  nt  ddk中，对于这些oid

  ddk文本指明了相关的对象能否通过miniportqueryinformation查询参数和通过miniportsetinformation设置参数。
oid也可被分为操作特性（如多目地址表长度参数）和统计参数（如广播包接收）。最后oid可分为必须的和可选的两种。
oid的前三个字节表明oid的不同类别，而最后一个字节确定这一类别内特定的信息管理对象。
针对于fddi网卡，被查询的oid的第一个字节为0x03。而ndis所查询的介质相关参数为：
0x03010104  oid_fddi_long_max_list_size
0x

《windows nt环境下fddi网卡驱动程序设计(第5页)》