NdisWriteConfiguration 関数 (ndis.h)

[アーティクル]
06/08/2024

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)