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) |