NdisFreeString 宏 (ndis.h)

NdisFreeString 函数释放由 NdisInitializeString 为缓冲字符串分配的存储。

语法

void NdisFreeString(
  [in]  String
);

参数

[in] String

描述要释放的字符串的NDIS_STRING类型值。 对于 Windows 2000 及更高版本,NDIS 将NDIS_STRING类型定义为 UNICODE_STRING 类型。

返回值

备注

NDIS 驱动程序通常在初始化期间调用 NdisInitializeString 函数,例如,设置传递给 NdisXxx配置 函数的名称。 对于驱动程序对 NdisInitializeString 进行的每个调用,驱动程序必须对 NdisFreeString 进行相应的调用。 释放在初始化期间分配的字符串缓冲区时,驱动程序必须在驱动程序的初始化函数返回控件之前调用 NdisFreeString

NdisFreeString 必须仅用于释放使用 NdisInitializeString 分配的缓冲区。

要求

要求
最低受支持的客户端 支持 NDIS 6.0 及更高版本中的现有驱动程序,但新驱动程序应改用 RtlFreeAnsiString 或 RtlFreeUnicodeString。
目标平台 桌面
标头 ndis.h (包括 Ndis.h)
IRQL PASSIVE_LEVEL
DDI 符合性规则 Irql_Miscellaneous_Function (ndis)

另请参阅

ANSI_STRING

NDIS 协议驱动程序的 DriverEntry

MiniportInitializeEx

NdisOpenAdapterEx

NdisRegisterProtocolDriver

ProtocolBindAdapterEx

RtlInitString

RtlInitUnicodeString

RtlUnicodeStringToAnsiString

UNICODE_STRING