|
|
PCAUSA NDIS Developer Tools
|
 | |
| |
|
NDIS Status Lookup - NDIS_STATUS Value/MACRO Name Lookup Tool |
A link to download PCAUSA NDIS Developer Tools is at the end of this page.
OID Scope is a Win32 application that provides a simple way to explore information related to NDIS miniports from a simple user-mode application. OID Scope allows the user to:
| Enumerate installed NDIS miniports. | ||||||
| View NDIS properties of a selected miniport
| ||||||
| Make any NDIS query supported by the miniport |
OID Scope is based on the Windows NT 4.0 DDK MACADDR sample application.
The NT 4.0 MACADDR sample illustrated the use of Win32 DeviceIoControl calls to access NDIS miniport drivers using IOCTL_NDIS_QUERY_GLOBAL_STATS. Using this IOCTL a Win32 application can have limited access to a NDIS MAC driver without needing the support of a companion NDIS protocol driver. This can be useful to network-aware applications - especially MAC vendor diagnostic tools.
The NT 4.0 MACADDR sample was a simple console application that was invoked from the command line. In those days a NDIS miniport was identified by a simple name like "EL905B". With names so short (and meaningful) using the command line was practical. The application fetched the adapter's current 802.3 address.
Windows 2000 introduced NDIS 5.0 and new miniport naming conventions. NDIS adapter names on NDIS 5.0 and higher are globally-unique identifiers (GUIDs) like "{9c9770b5-cfbc-41df-be1d-510cec826190}". Hardly practical to enter form the command-line.
OID Scope extends MACADDR from a simple console application to a more functional Windows MFC application. Adapters are enumerated using the SetupDi API (Windows 2000 and higher), and NDIS information about each adapter is displayed as a tabbed dialog. OID Scope also allows the user to select and make any NDIS query supported by the miniport.
OID Scope uses the IOCTL_NDIS_QUERY_GLOBAL_STATS method to allow a developer to select any NDIS adapter and to perform any NDIS query that the adapter supports.
OIDScope uses the technique of using IOCTL_NDIS_QUERY_GLOBAL_STATS to access a NDIS miniport driver. This technique will NOT work on the Windows 9X/ME platforms. Sorry!
When OID Scope is initially run it presents an adapter chooser dialog:
Select the desired network adapter and then press the Properties button. The OID Scope adapter property sheet will be displayed:
The data provided on the Basic property page and Statistics Property Page should be easy to understand. There is also an 802.11 Property Page if the selected adapter is a Wi-Fi adapter.
The Basic property page also allows you to perform some additional operations:
| Fetch the adapters supported OID list. |
| Fetch the adapter's supported GUID (WMI) list. |
| Select and perform any NDIS query that is supported by the adapter. |
Pressing the Make NDIS Query button brings up a Select OID To Query Dialog that allows you to select the query that you want to make.
There are actually three ways to select an OID to query:
| Supported OIDs - Select from the list of OIDs that the adapter's supported OID list. |
| All Defined OIDs - Select from the list of all OIDs that are currently defined (through Windows Server 2003) |
| Custom OID - Enter a HEX representation of any OID desired. |
The radio buttons are used to control which query selection field is used.
Use care when selecting OIDs to be queried. The lists includes OIDs that are set only (should not be queried) as well as OIDs that may not be appropriate for the actual adapter.
When specifying a custom OID any unexpected behavior is completely the responsibility of the user. This is especially true when making queries in the vendor-specific range.
Then press the Make Query button to see the selected query results. The Query Results Dialog presents that query results in an appropriate format.
The dialog can automatically update the query by checking the Auto-Update Enable box.
|
Need a Pocket PC 2002 or Pocket PC
2003 version
of OID Scope? |
The OID Lookup tool is a utility whose sole purpose is to provide a convenient way to lookup:
| An OID MACRO name from an OID value. |
| An OID value from an OID MACRO name. |
The snapshot below illustrates the OID Lookup Tool dialog.
| To lookup an OID MACRO name, enter the OID value
(as Hex or decimal) in the OID Value edit field and then press the "Lookup OID
MACRO Name" button. |
| To lookup an OID value, enter (or paste) the OID MACRO name in the OID MACRO Name edit field and then press the "Lookup OID Value" button. |
The NDIS Status Lookup tool is a utility whose sole purpose is to provide a convenient way to lookup:
| An NDIS_STATUS MACRO name from an NDIS_STATUS value. |
| An NDIS_STATUS value from an NDIS_STATUS MACRO name. |
The snapshot below illustrates the NDIS Status Lookup Tool dialog.
| To lookup an NDIS_STATUS MACRO name, enter the
NDIS_STATUS value
(as Hex or decimal) in the STATUS Value edit field and then press the "Lookup
STATUS Defined Name" button. |
| To lookup an NDIS_STATUS value, enter (or paste) the NDIS_STATUS MACRO name in the STATUS Defined Name edit field and then press the "Lookup STATUS Value" button. |
As a shortcut, when looking up a NDIS_STATUS value you can omit the "NDIS_STATUS_" prefix to the MACRO name. For example, you can simply enter "buffer_too_short" to find the value for "NDIS_STATUS_BUFFER_TOO_SHORT".
Please let us know if you encounter difficulties using these programs or if you have suggestions for improvement.
We will consider incorporating your suggestions into future versions and posting them here.
The PCAUSA NDIS Developer Tools software is provided "as is", without any guarantee made as to its suitability or fitness for any particular use. It may contain bugs, so use these tools at your own risk. PCAUSA takes no responsibly for any damage that may unintentionally be caused through its use.
If someone wants these items, then they must download them from the PCAUSA website.
The PCAUSA NDIS Tools are available for download as a Windows Installer setup file:
Windows Installer MSI File:
NdisTools MSI File
5.26 MB (5,521,408bytes)
Windows Installer Setup File:
NdisToolsSetup
5.26 MB (5,521,408bytes)
The installer isn't currently smart enough to handle updates gracefully.
Sorry...
| v6.0.2002 - November, 2006 | Small modification to show 802.11 page on Intel 3945ABG NDIS 5 NICs on pre-Vista Windows versions. | ||||||||||||||||
| V5.5.18.05 - August, 2006 | Added limited support for Windows Vista Native Wi-Fi. | ||||||||||||||||
| V5.5.18.05 - May, 2006 | Added limited support for Windows Vista Beta 2 (Build 5384). | ||||||||||||||||
| V5.5.18.01 - September, 2004 | Fixed a bug that caused OIDScope to fail to detect some 802.11g adapters. | ||||||||||||||||
| V5.5.17.00 - April, 2004 |
|
||||||||||||||||
| March 1, 2004 - V5.5.17.58 | Various improvements. | ||||||||||||||||
| December 29, 2003 - V5.03.16.57 | Modified to allow 32-bit OIDScope to work on 64-bit Windows. Also works on Windows Longhorn Build 4051. | ||||||||||||||||
| May 29, 2003 | Added Wi-Fi Protected Access (WPA) OID support to OID Scope. | ||||||||||||||||
| March 20, 2002 | Added NDIS Status Lookup Tool. | ||||||||||||||||
| November 16, 2001 | Initial release of PCAUSA NDIS Developer Tools. |
.
3/30/06
|
PCAUSA Home ·
Privacy Statement ·
Products ·
Ordering ·
Support ·
Utilities ·
Resources
|
