NdisFreeString マクロ (ndis.h)
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 を使用する必要があります。 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | ndis.h (Ndis.h を含む) |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 を する | Irql_Miscellaneous_Function(ndis) |
関連項目
NDIS プロトコル ドライバーの DriverEntry
NdisOpenAdapterEx の
NdisRegisterProtocolDriver の
RtlInitString の
RtlInitUnicodeString を する
RtlUnicodeStringToAnsiString の