This documentation is archived and is not being maintained.

Using a Notify Object DLL with a Filter Intermediate Driver (NDIS 5.1)

Note   NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.

You can use a notify object DLL with your filter intermediate driver to provide a user interface for the entry of component-specific parameters and configuration information.

To use a notify object DLL with a filter intermediate driver, you must create the DLL and install it from the intermediate driver protocol INF file.

The protocol INF file must include the following attributes to install the notify object:

  • You must define the ClsID and ComponentDll INF file entries as follows:


HKR, Ndi, ClsID, , {df2e4f67-e93a-11d1-bb14-0000f8779051}
HKR, Ndi, ComponentDll, , passthru.dll

You should change Passthru.dll to the name of your notify object DLL. You should also change the ClsID to a new ID that you created with the Uuidgen.exe tool.

  • Define the NCF_HAS_UI flag in the Characteristics entry. The values of this NCF_* flags are defined in netcfgx.h. A sample Characteristics entry follows:


Characteristics = 0x490

The 0x490 value indicates that NCF_HAS_UI , NCF_FILTER and NCF_NO_SERVICE are set.

  • Add the name of the Notify Object DLL to the copy files list as follows:


[SourceDisksFiles]
passthru.dll=1
passthru.sys=1

  • Substitute the name of your notify object DLL for passthru.dll.

  • Add an new section name to the copy files line. Include the files you need to install to support your notify object DLL in the new copy files section as shown:


CopyFiles=Passthru.CopyFiles.Sys, Passthru.CopyFiles.Init

[Passthru.CopyFiles.Init]
passthru.dll,,,2

 

 

Send comments about this topic to Microsoft

Show: