|
|
|
|
|
 | Packet Monitoring
- Where the NDIS IM driver observes and records data as it
is exchanged between the transport and the miniport. | ||||||||||||||
| Encryption -
Where the NDIS IM driver is used to encrypt and decrypt
data as it is exchanged between the transport and the miniport. | ||||||||||||||
| Packet Filtering - The ability to intercept and
possibly alter the flow of packets between the higher-level transport and lower-level NIC
drivers.
|
The PCAUSA NDIS IM driver samples currently include three sample drivers:
| Active PassThru - Adds mechanism to "clone" send
and receive packets and a centralized packet filtering module. Baseline for
other PCAUSA samples. |
| Packet Redirector - Extends Active PassThru to
illustrate packet monitoring packets sent/received and illustrates selective
packet blocking. |
| CryptoPing - Illustrates modification of packets. |
These sample drivers are NDIS 5 Intermediate filter drivers; they are not NDIS 6 Lightweight filter (LWF) drivers.
The NDIS 5 IM filter drivers can operate on Windows Vista, although NDIS 6 LWF drivers are preferred on Vista.
Active PassThru NDIS
Intermediate Driver
The PCAUSA Active PassThru sample makes a complete private "clone" of every other packet sent or received. The clone is is passed along instead of simply re-wrapping packets. The mechanics of building the cloned packet is on of the first challenges facing a NDIS IM driver developer.
The Active PassThru sample is the baseline for building other PCAUSA NDIS IM driver samples.
IP Packet Redirector NDIS Intermediate Driver
This sample starts with the Active PassThru sample and adds a mechanism that allows a Win32 application to interact with the packet stream that passes through the NDIS IM driver.
The Packet Redirector illustrates two important uses of a NDIS IM driver:
| Packet Monitoring
- Where the NDIS IM driver observes and records data as it
is exchanged between the transport and the miniport. |
| Packet Filtering - The ability to selectively Pass/Drop Packets. |
"CryptoPing" Packet Encrypting NDIS Intermediate Driver
The CryptoPing sample takes the PassThru baseline and extends it to illustrate a NDIS IM driver that performs modification to transmitted and received network packets.
| Encryption -
Where the NDIS IM driver is used to encrypt and decrypt
data as it is exchanged between the transport and the miniport. |
The sample performs simple in-place "encryption" of transmitted ICMP Echo Request ("ping" requests) packets and an inverse decryption of received ICMP Echo Reply packets.
It is your responsibility to setup the device driver build environment. In addition, it is your responsibility to learn the general techniques used to build and debug Windows device drivers.
If this is your first experience in device driver development, it is likely that you will encounter problems in simply setting up the Device Driver Kit (DDK) or the newer Windows Vista Windows Driver Kit (WDK). Some of these problems can be very frustrating to the uninitiated. When you undergo these trials for the first time, please have patience.
The PCAUSA NDIS IM Driver Samples can be built under:
| Windows 2000 or Higher Target - Windows 2000 Build Environment |
| Windows XP or Higher Target - Windows XP Build Environment |
| Windows XP or Higher Target x64 Editions - Windows Server 2003 x64 Build Environment |
PCAUSA currently uses the Windows 2000 Build Environment provided by the Windows Server 2003 R2 DDK (Build 3790.1830) to build for Windows 2000. PCAUSA uses the Windows Vista WDK (Build 6000) to build for Windows XP and higher.
The driver build for the Windows 2000 platform will run on Windows 2000 and higher platforms.
A programmer intending to write NDIS Intermediate drivers should have prior experience in development and debugging of Windows device drivers.
The PCAUSA NDIS IM Demo Executables can be downloaded as a ZIP from the following URL:
NDISIMDemo.zip
171.17KB (175279 bytes)
After unzipping the file, please read the documentation in the Readme.htm files in this folder:
\PCADemo\NDIS IM\Readme.htm
You can also view the current Release Notes.
The product includes a royalty-free license to incorporate sample code into your executable products. Please review the PCAUSA License Agreement and Limited Warranty.
|
Prices good through June 30, 2008.
3/27/06
|
PCAUSA Home ·
Privacy Statement ·
Products ·
Ordering ·
Support ·
Utilities ·
Resources
|
