NdisInitializeString 関数 (ndis.h)

[アーティクル]
02/29/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 メンバーを設定し、宛先文字列を 0 で終了します。 Windows 2000 以降のドライバーの場合、NdisInitializeString は、指定されたソース文字列を Unicode 文字に変換します。

SourceString は NULL にすることはできません。

NdisInitializeString によって割り当てられたバッファーは、NdisFreeString 関数を使用して解放する必要があります。

要件

要件	値
サポートされている最小のクライアント	NDIS 6.0 以降の既存のドライバーでサポートされていますが、新しいドライバーでは RtlInitUnicodeString または RTL_CONSTANT_STRING または DECLARE_CONST_UNICODE_STRING (ntdef.h を参照) を代わりに使用する必要があります。
対象プラットフォーム	ユニバーサル
Header	ndis.h (Ndis.h を含む)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	Irql_Miscellaneous_Function(ndis)