NdisWriteConfiguration 関数 (ndis.h)
NdisWriteConfiguration 関数は、指定されたエントリの呼び出し元から指定された値をレジストリに書き込みます。 この関数は、それ自体と NdisReadConfiguration 関数に対してシリアルに呼び出す必要があります。
構文
void NdisWriteConfiguration(
[out] PNDIS_STATUS Status,
[in] NDIS_HANDLE ConfigurationHandle,
[in] PNDIS_STRING Keyword,
[in] PNDIS_CONFIGURATION_PARAMETER ParameterValue
);
パラメーター
[out] Status
呼び出し元が指定した変数へのポインター。この関数は、呼び出しの状態を次のいずれかとして返します。
NDIS_STATUS_SUCCESS
ParameterValue で指定された値がレジストリに書き込まれた。 これが新しいエントリの場合、 Keyword の名前もレジストリに書き込まれます。
NDIS_STATUS_NOT_SUPPORTED
指定された ParameterType が無効です。
NDIS_STATUS_RESOURCES
NDIS では、要求された情報をレジストリに転送するために、通常は十分なメモリであるリソースを割り当てませんでした。
NDIS_STATUS_FAILURE
要求された情報を書き込めませんでした。
[in] ConfigurationHandle
NdisOpenConfigurationEx によって返されたレジストリ キーへのハンドル。 NdisOpenConfigurationKeyByIndex、または NdisOpenConfigurationKeyByName 関数。
[in] Keyword
呼び出し元が指定したカウント文字列を記述するNDIS_STRING型へのポインター。システムの既定の文字セットで、値を書き込むエントリの名前を指定します。 Microsoft Windows 2000 以降のドライバーの場合、この文字列には Unicode 文字が含まれます。 つまり、Windows 2000 以降の場合、NDIS はNDIS_STRING型を UNICODE_STRING 型として定義します。
[in] ParameterValue
呼び出し元が指定したポインター NDIS_CONFIGURATION_PARAMETER 構造体。
戻り値
なし
解説
開いているレジストリ キーの下に、 キーワード と同じ名前のエントリが既に存在する場合、 NdisWriteConfiguration は現在の値を呼び出し元が指定した値に置き換えます。 それ以外の場合、 NdisWriteConfiguration は、指定された名前と指定された値を持つ新しい値エントリをレジストリに追加します。
Windows 2000 以降のバージョンの構成レジストリでは、NDIS キーワード は 値エントリ名のシノニムです。 このような名前は、Null 文字で終わる Unicode 文字のカウントされたシーケンスです。
NdisWriteConfiguration は、 Keyword で呼び出し元が指定した文字列と 、ParameterValue で指定された呼び出し元が指定したデータをバッファーしてコピーします。 このメモリは、ドライバーが NdisCloseConfiguration 関数を使用して ConfigurationHandle を解放すると解放されます。 NdisWriteConfiguration の呼び出し元は、Keyword でバッファーされた文字列と、 に割り当てられたメモリを解放する役割を担います。 NDIS_CONFIGURATION_PARAMETER 構造体。
NdisWriteConfiguration を呼び出す代わりに、すべての NDIS ドライバーは、ドライバーの INF ファイルの AddReg ディレクティブを使用して、それ自体のレジストリに構成情報を設定できます。
Windows 2000 以降のバージョンのセットアップ ファイルとインストール ファイルの詳細については、「 デバイスのインストールの概要」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (NdisWriteConfiguration (NDIS 5.1) を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (「NdisWriteConfiguration (NDIS 5.1)」を参照) でサポートされています。 |
| 対象プラットフォーム | ユニバーサル |
| Header | ndis.h (Ndis.h を含む) |
| Library | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 | Irql_Miscellaneous_Function(ndis) |