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 的 LengthMaximumLength 成员,并使用零终止目标字符串。 对于 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)

另请参阅

ANSI_STRING

NDIS 协议驱动程序的 DriverEntry

MiniportInitializeEx

RtlAnsiStringToUnicodeString

RtlEqualUnicodeString

RtlFreeAnsiString

RtlFreeUnicodeString

RtlInitString

RtlInitUnicodeString

RtlUnicodeStringToAnsiString

UNICODE_STRING