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 結構。
傳回值
無
備註
如果已開啟的登錄機碼底下已有與 At Keyword 相同的名稱專案， NdisWriteConfiguration 會以呼叫端提供的值取代其目前值。 否則， NdisWriteConfiguration 會將具有指定名稱和提供值的新值專案新增至登錄。
在 Windows 2000 和更新版本的組態登錄中，NDIS 關鍵詞 與 值專案名稱同義。 這類名稱是 Unicode 字元的計數序列，以 Null 字元終止。
NdisWriteConfiguration 緩衝區，並將呼叫端提供的字串複製到 Keyword 和 ParameterValue 指定的呼叫端提供的數據。 當驅動程式使用 NdisCloseConfiguration 函式釋放 ConfigurationHandle 時，會釋放此記憶體。 NdisWriteConfiguration 的呼叫端負責釋放 Keyword 的緩衝字串，以及為 配置給 的記憶體 NDIS_CONFIGURATION_PARAMETER 結構。
除了呼叫 NdisWriteConfiguration，每個 NDIS 驅動程式都可以使用驅動程式 INF 檔案中的 AddReg 指示詞，在登錄中自行設定組態資訊。
如需 Windows 2000 和更新版本之安裝和安裝檔案的詳細資訊，請參閱 裝置安裝概觀。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | (支援 NDIS 6.0 和 NDIS 5.1 驅動程式，請參閱 Windows Vista 中的 NdisWriteConfiguration (NDIS 5.1) ) 。 (支援 NDIS 5.1 驅動程式，請參閱 Windows XP 中的 NdisWriteConfiguration (NDIS 5.1) ) 。 |
| 目標平台 | Universal |
| 標頭 | ndis.h (包含 Ndis.h) |
| 程式庫 | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| DDI 合規性規則 | Irql_Miscellaneous_Function (ndis) |