readme

在CE下实现ndis的源代码

IMPORTANT NOTE:
This is a demo & test version of ndis3pkt for CE 1.0.  It is restricted
to sending 75/receiving 200 packets per soft reset.  It has been tested with
Windows/CE 3.0 on the ARM processor.

Refer to ORDER.TXT in ndis3ce.zip for information on obtaining a full
version of ndis3pkt for CE 1.0.

NDIS3PKT for CE 1.0 demo (c) Copyright Daniel D. Lanciani 1994-2003
All rights reserved.

This demonstration version of NDIS3PKT is licensed exclusively
for testing and evaluation purposes.  It may not be distributed
for profit, nor may it be included in products or otherwise distributed
by commercial entities to their clients or customers without the prior
written permission of the author.

TO THE EXTENT ALLOWED BY APPLICABLE LAW, NDIS3PKT IS PROVIDED
"AS IS", WITH NO EXPRESS OR IMPLIED WARRANTY, INCLUDING, BUT
NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW WILL THE AUTHOR BE
LIABLE FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL
OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO
USE NDIS3PKT EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY
OF SUCH DAMAGES.

These copyright, license, and disclaimer notices must be included
with all copies of NDIS3PKT.



Ndis3pkt for CE (as implemented in ndis3ce.dll) provides a Win32 interface that
is highly compatible with the 9x and NT versions of ndis3pkt.  In addition, an
extension DLL (ndis3pds.dll) is provided for users of PocketDOS 1.074 or newer.
In conjunction with a real-mode stub driver (ndis3pkt.com) this allows packet
driver applications to be used within the emulated DOS environment.  An
informational program, ndisinfo.exe, lists bindings that can be accessed from
the packet driver interface.  Note that ndisinfo.exe is a Windows/CE console
application and requires that a console driver be available.  For CE platforms
that do not include such a driver by default, a third-party product such as
PocketConsole can be installed.


Installation:

Copy the ndis3ce.cab or ndis3ce4.cab file to the target device and execute
it with file explorer.  Use the ndis3ce.cab file for CE 3.0 devices (e.g.,
PocketPC2002) and the ndis3ce4.cab file for CE 4.x devices (e.g., PocketPC2003).
The installer should:

-Add necessary registry entries
-Copy ndis3pkt files to the appropriate Windows directories

Soft-reset the device to activate the packet driver interface.  The Win32
API should now be available.

In order to enable packet driver support in an emulated DOS session, you must
run the stub driver ndis3pkt.com from the command.com prompt.  The first
optional argument selects a particular CE device (default 0) and the second the
packet driver vector (default 0x69).  You can run ndisinfo.exe to get a list of
device numbers and a list of devices used by MSTCP.


Additional ndis3pkt options can be set under the registry entry
HKLM\Drivers\Builtin\Ndis3ce.  All options are type DWORD.

debug
Log extra debugging messages (default 0).  Debugging information is saved
in \ndis3pkt.txt.

buffers
Specify number of buffers for packets (max 50, min 2, default 10).

rif0
Set first default RIF byte for Ethernet over Token Ring (default 0xc2).

rif1
Set second default RIF byte for Ethernet over Token Ring (default 0x20).

tcpmux
Enable tcp multiplexor (default 1).

mstcpmux
Enable tcp multiplexor for MSTCP (default 1).

warnmuxfull
Issue warning when tcp multiplexor table is full (default 1).

ignorelocalbroadcast
Ignore broadcast packets that originate in the local machine (default 1).

net80230
Force 802.3 framing and packet class 11 (default 0).  IT IS
EXTREMELY UNLIKELY THAT YOU WANT TO USE THIS OPTION.

fakeether0
Pretend to be an Ethernet device even on Token Ring (default 1).

(It is possible to configure more than one network card using additional
keys, e.g., net80231, fakeether1, net80232, fakeether2, etc.)


Uninstallation:

Because the ndis3ce.dll file is in use and locked during normal operation
it cannot be deleted without first disabling the driver.  A utility to
remove the appropriate entry from the registry is provided as undis3ce.exe.
After running this program you must soft-reset the device.  It will then be
possible to uninstall the package using the normal Remove Programs menu.



------------------------------------------------------------------------------
All versions of ndis3pkt for CE provide a Win32 DeviceIoControl API to
support direct packet access by 32-bit applications.  Sample functions
for calling the API are provided in the file ndis3api.c.
------------------------------------------------------------------------------
Starting with version 1.0, ndis3pkt for CE provides a Win32 API for implementing
user-mode intermediate drivers.  Refer to WIN32IM.TXT for more information.
------------------------------------------------------------------------------


Please send bug reports to [e-mail] or

Dan Lanciani
185 Atlantic Road
Gloucester, MA 01930
[phone]
Fax: [phone]