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