NdisFreeString 宏（ndis.h）

项目
02/07/2025

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）