NdisFreeString 宏 (ndis.h)

项目
02/26/2024

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)