NdisInitializeString 函数 (ndis.h)

项目
08/07/2023

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)