NdisInitializeString 函式 (ndis.h)

發行項
03/01/2024

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) 。
目標平台	Universal
標頭	ndis.h (包含 Ndis.h)
程式庫	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI 合規性規則	Irql_Miscellaneous_Function (ndis)