NdisWriteConfiguration 関数 (ndis.h)

[アーティクル]
02/07/2025

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 構造体。

戻り値

何一つ

備考

Keyword と同じ名前のエントリが既に開いているレジストリキーの下に存在する場合は、NdisWriteConfiguration 現在の値を呼び出し元が指定した値に置き換えます。それ以外の場合 NdisWriteConfiguration は、指定された名前と指定された値を持つ新しい値エントリをレジストリに追加します。

Windows 2000 以降のバージョンの構成レジストリでは、NDIS キーワード は、値のエントリ名のシノニムです。このような名前は、Null 文字で終わる Unicode 文字のカウントシーケンスです。

NdisWriteConfiguration バッファーし、呼び出し元が指定した文字列をコピー キーワード と呼び出し元が指定したデータ ParameterValue で指定します。このメモリは、ドライバーが NdisCloseConfiguration 関数を使用して ConfigurationHandle を解放すると解放されます。 NdisWriteConfiguration の呼び出し元は、キーワード でバッファーされた文字列と、そのメモリに割り当てられたメモリを解放する役割を担います。 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) を参照) でサポートされます。
ターゲットプラットフォームの	万国
ヘッダー	ndis.h (Ndis.h を含む)
ライブラリ	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則をする	Irql_Miscellaneous_Function(ndis)

次の方法で共有