NdisInitializeString 函数（ndis.h）

项目
02/07/2025

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 为目标字符串设置 Length 和 MaximumLength NDIS_STRING 成员，并将目标字符串终止为零的目标字符串。对于 Windows 2000 及更高版本的驱动程序，NdisInitializeString 将提供的源字符串转换为 Unicode 字符。

SourceString 不得 NULL。

应使用 NdisFreeString 函数释放由 NdisInitializeString 分配的缓冲区。

要求

要求	价值
最低支持的客户端	支持 NDIS 6.0 及更高版本中的现有驱动程序，但新驱动程序应改用 RtlInitUnicodeString 或RTL_CONSTANT_STRING或DECLARE_CONST_UNICODE_STRING（请参阅 ntdef.h）。
目标平台	普遍
标头	ndis.h （包括 Ndis.h）
库	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI 符合性规则	Irql_Miscellaneous_Function（ndis）