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 ddl@danlan.com or Dan Lanciani 185 Atlantic Road Gloucester, MA 01930 (978) 283-4974 Fax: (978) 281-7191