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型別的指標，指定要寫入值的項目名稱。 對於 windows 2000 和更新版本的驅動程式Microsoft，此字串包含 Unicode 字元。 也就是說，針對 Windows 2000 和更新版本，NDIS 會將NDIS_STRING類型定義為 UNICODE_STRING 類型。
[in] ParameterValue
提供呼叫端的指標 NDIS_CONFIGURATION_PARAMETER 結構。
傳回值
沒有
言論
如果已開啟的登錄機碼下已有與 Keyword 相同名稱的專案，NdisWriteConfiguration 會以呼叫端提供的值取代其目前值。 否則，NdisWriteConfiguration 將具有指定名稱和提供值的新值專案新增至登錄。
在 Windows 2000 和更新版本的設定登錄中，NDIS Keyword 是 值專案名稱的同義字。 這類名稱是 Unicode 字元的計數序列，以 Null 字元結尾。
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）。 |
| 目標平臺 | 普遍 |
| 標頭 | ndis.h （包括 Ndis.h） |
| 連結庫 | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| DDI 合規性規則 | Irql_Miscellaneous_Function（ndis） |