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.

Syntax


VOID NdisFreeString(
  _In_  NDIS_STRING String
);

Parameters

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.

Return value

None

Remarks

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.

Requirements

Version

See NdisFreeString.

Header

Ndis.h (include Ndis.h)

IRQL

PASSIVE_LEVEL

See also

ANSI_STRING
DriverEntry of NDIS Protocol Drivers
MiniportInitialize
NdisFreeMemory
NdisInitializeString
NdisOpenAdapter
NdisRegisterProtocol
ProtocolBindAdapter
UNICODE_STRING

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft