diff options
| author | Barry Golden <[email protected]> | 2015-08-06 20:06:07 -0700 |
|---|---|---|
| committer | Barry Golden <[email protected]> | 2015-08-06 20:06:07 -0700 |
| commit | 9026073a419b5ef68fb46d4f7fae52dbef09dbe1 (patch) | |
| tree | b81f73f650af9ac82a7e8739e989456f6e192b37 /network/ndis/ndisprot_kmdf | |
| parent | bd17fd844b4f074821b9d4c7bc86b9dc7f0e4a59 (diff) | |
Remove obsolete readme.htm files
Diffstat (limited to 'network/ndis/ndisprot_kmdf')
| -rw-r--r-- | network/ndis/ndisprot_kmdf/ndisprot.htm | 197 |
1 files changed, 0 insertions, 197 deletions
diff --git a/network/ndis/ndisprot_kmdf/ndisprot.htm b/network/ndis/ndisprot_kmdf/ndisprot.htm deleted file mode 100644 index 88dc4d38..00000000 --- a/network/ndis/ndisprot_kmdf/ndisprot.htm +++ /dev/null @@ -1,197 +0,0 @@ -<html> - -<head> -<title>Sample NDIS connection-less protocol driver sample</title> -</head> - -<body lang=EN-US link=blue vlink=blue style='tab-interval:.5in'> - -<div class=Section1> - -<h2><span style='font-family:Verdana'>NDIS connection-less protocol driver sample</span></h2> - -<h3><span style='font-family:Verdana'>SUMMARY</span></h3> - -<p><span style='font-size:10.0pt;font-family:Verdana'>This sample demonstrates a connection-less -NDIS 5.0, 5.1 or 6.0 protocol driver. The driver supports sending and receiving raw Ethernet -frames using ReadFile/WriteFile calls from user-mode. As an NDIS protocol, it illustrates how to -establish and tear down bindings to Ethernet adapters, i.e. those that export medium type -<i>NdisMedium802_3</i>. It shows how to set a packet filter, send and receive data, and handle -plug-and-play events.</span></p> - -<p><span style='font-size:10.0pt;font-family:Verdana'>The sample works on Windows 2000 and later -platforms.</span></p> - -<p><span style='font-size:10.0pt;font-family:Verdana'>The sample also demonstrates how to write -a Notify Object dll. The Notify Object is used for calling into the Wdf Coinstaller to install -and load the framework library.</span></p> - -<h3><span style='font-family:Verdana'>BUILDING THE SAMPLE</span></h3> - -<p><span style='font-size:10.0pt;font-family:Verdana'>From the Free or Checked Build environment, -execute <b>build -ceZ</b> in the ndisprot directory.</span></p> -<p> -<p><span style='font-size:10.0pt;font-family:Verdana'>Depending on the build environment, the 50 -subdirectory produces either NDIS5.0 or NDIS 5.1 compatible driver. If built in the Windows 2000 -build environment, it will produce NDIS 5.0 compatible driver. If it's built in the Windows XP or -Window Server 2003 build environment, it will produce NDIS 5.1 compatible driver.</span></p> -<p> -<p><span style='font-size:10.0pt;font-family:Verdana'>The 60 subdirectory can be built only in the -Windows Vista build environment. The sample built in this sub directory will be NDIS 6.0 compatible -and will work on Windows Vista and later operating systems.</span></p> - - -<h3><span style='font-family:Verdana'>INSTALLATION</span></h3> - -<p><span style='font-size:10.0pt;font-family:Verdana'>The driver is installed using the INF file -ndisprot.inf, which is provided in the driver directory. In Network Connections UI, select an -adapter and open <b>Properties</b>.</span></p> - -<p><span style='font-size:10.0pt;font-family:Verdana'>Click <b>Install</b>, then <b>Protocol</b>, -then <b>Add</b>, and then <b>Have disk</b>. Then point to the location of the .inf and driver.</span></p> - -<p><span style='font-size:10.0pt;font-family:Verdana'>Select <b>Sample NDIS Protocol Driver </b>and -click <b>OK</b>. After installing the protocol, copy over the test application files uiotest.exe and -protest.exe to a convenient location. Please note that the driver service has been set to manual -start in the INF file. As a result, it doesn't get loaded automatically when you install.</span></p> - -<h3><span style='font-family:Verdana'>USAGE</span></h3> - -<p><span style='font-size:10.0pt;font-family:Verdana'>To start the driver, type<br> -<span style='mso-tab-count:1'>��������� </span>Net start ndisprot</span></p> - -<p><span style='font-size:10.0pt;font-family:Verdana'>To stop the driver, type<br> -<span style='mso-tab-count:1'>��������� </span>Net stop ndisprot</span></p> - -<p><span style='font-size:10.0pt;font-family:Verdana'>To test the NDIS 5.x driver, run uiotest. -For help on usage, run uiotest -?</span></p> - -<pre style='margin-left:.5in'> -usage: UIOTEST [options] <devicename> -options: -<span style='mso-spacerun:yes'>������ </span>-e: Enumerate devices -<span style='mso-spacerun:yes'>������ </span>-r: Read -<span style='mso-spacerun:yes'>������ </span>-w: Write (default) -<span style='mso-spacerun:yes'>������ </span>-l <length>: length of each packet (default: 100) -<span style='mso-spacerun:yes'>������ </span>-n <count>: number of packets (defaults to infinity) -<span style='mso-spacerun:yes'>������ </span>-m <MAC address> (defaults to local MAC)</pre> - -<p><span style='font-size:10.0pt;font-family:Verdana'>To test the NDIS 6.0 driver, run prottest. -For help on usage, run prottest -?</span></p> - -<pre style='margin-left:.5in'> -usage: PROTTEST [options] <devicename> -options: -<span style='mso-spacerun:yes'>������ </span>-e: Enumerate devices -<span style='mso-spacerun:yes'>������ </span>-r: Read -<span style='mso-spacerun:yes'>������ </span>-w: Write (default) -<span style='mso-spacerun:yes'>������ </span>-l <length>: length of each packet (default: 100) -<span style='mso-spacerun:yes'>������ </span>-n <count>: number of packets (defaults to infinity) -<span style='mso-spacerun:yes'>������ </span>-m <MAC address> (defaults to local MAC)</pre> - -<p><span style='font-size:10.0pt;font-family:Verdana'>Uiotest/Prottest exercises the IOCTLs supported by -NDISPROT, and sends and/or receives data on the selected device. In order to use uiotest/prottest, the -user must have administrative privilege. Users should pass down a big enough buffer in order to receive -the entire received data. If the length of the buffer passed down is smaller than the length of the -received data, NDISPROT will only copy part of the data and discard the rest when the given buffer is -full.</span></p> - -<p><span style='font-size:10.0pt;font-family:Verdana'>For NDIS 5.x driver, use the �e option on uiotest -to enumerate all devices to which NDISPROT is bound:</span></p> - -<pre style='margin-left:.5in'> -C:\uio>uiotest -e - 0. \DEVICE\{9273DA7D-5275-4B9A-AC56-68A49D121F1F} -<span style='mso-spacerun:yes'>���� </span>- Intel-Based 10/100 Ethernet Card</pre> - -<p><span style='font-size:10.0pt;font-family:Verdana'>The following command sends and receives 2 packets -on a device. Since these packets are sent to the local MAC address (default), both packets are received. -The device name parameter to uiotest is picked up from the output of uiotest �e (see above).</span></p> - -<pre style='margin-left:.5in'> -C:\uio>uiotest -n 2 \DEVICE\{9273DA7D-5275-4B9A-AC56-68A49D121F1F} -DoWriteProc: finished sending 2 packets of 100 bytes each -DoReadProc finished: read 2 packets</pre> - -<p><span style='font-size:10.0pt;font-family:Verdana'>For NDIS 6.0 driver, use the �e option on prottest -to enumerate all devices to which NDISPROT is bound:</span></p> - -<pre style='margin-left:.5in'> -C:\prot>prottest -e - 0. \DEVICE\{9273DA7D-5275-4B9A-AC56-68A49D121F1F} -<span style='mso-spacerun:yes'>���� </span>- Intel-Based 10/100 Ethernet Card</pre> - -<p><span style='font-size:10.0pt;font-family:Verdana'>The following command sends and receives 2 packets -on a device. Since these packets are sent to the local MAC address (default), both packets are received. -The device name parameter to prottest is picked up from the output of protest �e (see above).</span></p> - -<pre style='margin-left:.5in'> -C:\prot>prottest -n 2 \DEVICE\{9273DA7D-5275-4B9A-AC56-68A49D121F1F} -DoWriteProc: finished sending 2 packets of 100 bytes each -DoReadProc finished: read 2 packets</pre> - -<p><span style='font-size:10.0pt;font-family:Verdana'>For security reasons, this driver does not allow -packets with fake MAC addresses to be sent from usermode applications.</span></p> - - -<h3><span style='font-family:Verdana'>TIPS</span></h3> - -<p><span style='font-size:10.0pt;font-family:Verdana'>With a checked version of ndisprot.sys, you can -control the volume of debug information generated by changing the variable ndisprotDebugLevel. Refer to -debug.h for more information.</span></p> - -<h3><span style='font-family:Verdana'>CODE TOUR</span></h3> - -<h4><span style='font-family:Verdana'>File Manifest</span></h4> - -<pre><span style='font-size:9.0pt;mso-bidi-font-size:7.5pt;font-family:Courier'><b>Directory: 50, 60</b> -<u>File</u><span style='mso-tab-count:2'>������������ </span><u>Description</u> -debug.c<span style='mso-tab-count:2'>����������</span>Routines to aid debugging -debug.h<span style='mso-tab-count:2'>��������� </span>Debug macro definitions -excallbk.c<span style='mso-tab-count:1'>������ </span>Handles load order dependency between this sample and NDISWDM sample -macros.h<span style='mso-tab-count:2'>�������� </span>Spinlock, event, referencing macros -ndisbind.c<span style='mso-tab-count:1'>������ </span>NDIS protocol entry points to handle binding/unbinding from adapters -ndisprot.h<span style='mso-tab-count:1'>������ </span>Data structure definitions -precomp.h<span style='mso-tab-count:1'>������ </span>Contains the precompiled headers -protuser.h<span style='mso-tab-count:1'>������ </span>Has the definitions of ioctls issued by protuser.exe application used on NDIS 6.0 -nuiouser.h<span style='mso-tab-count:1'>������ </span>Has the definitions of ioctls issued by nuiouser.exe application used on NDIS 5.0 -ndisprot.inf<span style='mso-tab-count:1'>���� </span>INF file for installing NDISPROT -ntdisp.c<span style='mso-tab-count:2'>�������� </span>NT Entry points and dispatch routines for NDISPROT -recv.c<span style='mso-tab-count:2'>���������� </span>NDIS protocol entry points for receiving data, and IRP_MJ_READ processing -send.c<span style='mso-tab-count:2'>���������� </span>NDIS protocol routines for sending data, and IRP_MJ_WRITE processing</span></pre> - -<pre><span style='font-size:9.0pt;mso-bidi-font-size:7.5pt;font-family:Courier'><b>Directory: NotifyOb</b> -<u>File</u><span style='mso-tab-count:2'>������������ </span><u>Description</u> -Common.hpp<span style='mso-tab-count:1'>�������</span>Header file containing the common include files for the project -dllmain.cpp<span style='mso-tab-count:1'>������</span>Handles loading/unloading of Wdf Coinstaller and the notify object dll -ProtNotify.cpp<span style='mso-tab-count:1'>���</span>Handles loading/unloading the WDF loader during the device installation/removal -ProtNotify.idl<span style='mso-tab-count:1'>���</span>Defines the interfaces for the notify object dll -ProtNotify.def<span style='mso-tab-count:1'>���</span>Defines the exports of notify object dll - -ProtNotify.rc<span style='mso-tab-count:1'>����</span>Resource file for the notify object dll -resource.h<span style='mso-tab-count:1'>������ </span>Defines the resource ids used by the notify object</span></pre> - -<p align=center style='text-align:center;tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt'><span -style='font-size:10.0pt;font-family:Verdana'><a href="#top">Top of page</a> <o:p></o:p></span></p> - -<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 width=624 - style='width:6.5in;mso-cellspacing:0in;mso-padding-alt:0in 0in 0in 0in'> - <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes; - height:1.5pt'> - <td style='background:aqua;padding:.75pt .75pt .75pt .75pt;height:1.5pt'> - <p class=MsoNormal><o:p> </o:p></p> - </td> - </tr> -</table> - -<p style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt'><span -style='font-size:7.5pt;font-family:"MS Sans Serif"'>� Microsoft Corporation -2000</span><span style='font-size:10.0pt;font-family:Verdana'> <o:p></o:p></span></p> - -</div> - -</body> - -</html> - - |