NdisInitializeString 函数 (ndis.h)
NdisInitializeString 函数为 系统默认字符集中的计数字符串分配存储并初始化。
语法
void NdisInitializeString(
PNDIS_STRING Destination,
PUCHAR Source
);
参数
Destination
指向具有 NULL 缓冲区的NDIS_STRING的指针。 从此函数返回时,NDIS_STRING包含已初始化的计数字符串。 对于 Windows 2000 及更高版本,NDIS 将NDIS_STRING类型定义为 UNICODE_STRING 类型。
Source
指向以 null 结尾的字符串的指针,用于初始化计数字符串。 SourceString 不得为 NULL。
返回值
无
备注
NdisInitializeString 为目标字符串设置 NDIS_STRING 的 Length 和 MaximumLength 成员,并使用零终止目标字符串。 对于 Windows 2000 及更高版本的驱动程序,NdisInitializeString 会将提供的源字符串转换为 Unicode 字符。
SourceString 不得为 NULL。
NdisInitializeString 分配的缓冲区应使用 NdisFreeString 函数释放。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 支持 NDIS 6.0 及更高版本中的现有驱动程序,但新驱动程序应使用 RtlInitUnicodeString 或 RTL_CONSTANT_STRING或DECLARE_CONST_UNICODE_STRING (改为参阅 ntdef.h) 。 |
目标平台 | 通用 |
标头 | ndis.h (包括 Ndis.h) |
Library | Ndis.lib |
IRQL | PASSIVE_LEVEL |
DDI 符合性规则 | Irql_Miscellaneous_Function (ndis) |