NdisFreeString マクロ (ndis.h)

[アーティクル]
08/07/2023

NdisFreeString 関数は、バッファー内の文字列に対して NdisInitializeString によって割り当てられたストレージを解放します。

構文

void NdisFreeString(
  [in]  String
);

パラメーター

[in] String

解放する文字列を記述するNDIS_STRING型の値。 Windows 2000 以降の場合、NDIS はNDIS_STRING型を UNICODE_STRING 型として定義します。

戻り値

なし

解説

通常、NDIS ドライバーは初期化中に NdisInitializeString 関数を呼び出して、 NdisXxx構成 関数に渡される名前を設定します。ドライバーが NdisInitializeString に対して行う呼び出しごとに、ドライバーは対応する NdisFreeString の呼び出しを行う必要があります。初期化中に割り当てられた文字列バッファーを解放する場合、ドライバーは、ドライバーの初期化関数がコントロールを返す前に NdisFreeString を呼び出す必要があります。

NdisFreeString は、 NdisInitializeString で割り当てられたバッファーを解放する場合にのみ使用する必要があります。

要件

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