Microsoft KB Archive/247154

From BetaArchive Wiki
Knowledge Base

NdisFreePacket Macro Causes NDIS Protocol Drivers to Fail in Windows 2000

Article ID: 247154

Article Last Modified on 11/1/2006


  • Microsoft Windows 2000 Professional Edition

This article was previously published under Q247154


When you use a computer running Microsoft Windows 2000 Professional to call the NdisAllocatePacket function, the third-party network driver interface specification (NDIS) protocol drivers may not work.


This problem occurs because the NdisFreePacket macro from the Microsoft Windows NT 4.0 Device Driver Kit (DDK) is not compatible with the NdisAllocatePacket function exported by Windows 2000.


To work around this behavior, you can use one of two methods:

Build the driver, and then recompile the NDIS protocol driver by using the Windows 2000 DDK.

NOTE: The Windows 2000 DDK defines both NdisAllocatePacket and NdisFreePacket as NDIS library exports. The resulting driver appears to work on both Windows NT 4.0 Service Pack 3 and Windows 2000 Beta 3.


Build the driver, using the Windows NT 4.0 DDK with a modified NdisFreePacket definition. The following fragment can be included after the #include for NDIS.H:

#if defined(NdisFreePacket)  
#undef NdisFreePacket    
VOID  NdisFreePacket(     IN PNDIS_PACKET Packet     );    

The fragment changes the Windows NT 4.0 MACRO definition for NdisFreePacket and forces use of the NdisFreePacket function exported by the NDIS library. The resulting driver appears to work on both Windows NT 4.0 Service Pack 3 and Windows 2000.


Microsoft has confirmed that this is a problem in Microsoft Windows 2000 Professional.

Additional query words: third party custom network

Keywords: kbbug kbpending KB247154