NdisFreeString (NDIS 5.1) function
Note NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.
NdisFreeString releases storage that was allocated by NdisInitializeString for a buffered string.
- String [in]
NDIS_STRING type that describes the string to release. For Windows 2000 and later, NDIS defines the NDIS_STRING type as a UNICODE_STRING type.
An NDIS driver typically calls NdisInitializeString during initialization--for example, to set up names passed to the NdisXxxConfiguration functions. For each call that it makes to NdisInitializeString, a driver must make a corresponding call to NdisFreeString. When releasing buffers allocated during initialization, a driver must call NdisFreeString before the driver's initialization function returns control.
NdisFreeString must be used only for freeing buffers that were allocated with NdisInitializeString.
- DriverEntry of NDIS Protocol Drivers