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 構造体。
戻り値
何一つ
備考
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) |
関連項目
NdisAnsiStringToUnicodeString のNdisCloseConfiguration の
NdisFreeMemory の
NdisFreeString の
NdisInitAnsiString の
NdisInitUnicodeString の
NdisInitializeString の
NdisOpenConfigurationEx の
NdisOpenConfigurationKeyByIndex NdisOpenConfigurationKeyByName をするNdisReadConfiguration の
NdisUnicodeStringToAnsiString の