Fungsi NdisWriteConfiguration (ndis.h)

Artikel
08/07/2023

Fungsi NdisWriteConfiguration menulis nilai yang disediakan penelepon untuk entri tertentu ke dalam registri. Fungsi ini harus dipanggil secara serial sehubungan dengan dirinya sendiri dan fungsi NdisReadConfiguration .

Sintaks

void NdisWriteConfiguration(
  [out] PNDIS_STATUS                  Status,
  [in]  NDIS_HANDLE                   ConfigurationHandle,
  [in]  PNDIS_STRING                  Keyword,
  [in]  PNDIS_CONFIGURATION_PARAMETER ParameterValue
);

Parameter

[out] Status

Penunjuk ke variabel yang disediakan penelepon di mana fungsi ini mengembalikan status panggilan sebagai salah satu hal berikut:

NDIS_STATUS_SUCCESS

Nilai yang disediakan di ParameterValue ditulis ke dalam registri. Jika ini adalah entri baru, nama di Kata Kunci juga ditulis ke dalam registri.

NDIS_STATUS_NOT_SUPPORTED

ParameterType yang disediakan tidak valid.

NDIS_STATUS_RESOURCES

NDIS tidak dapat mengalokasikan sumber daya, biasanya cukup memori, untuk mentransfer informasi yang diminta ke registri.

NDIS_STATUS_FAILURE

Informasi yang diminta tidak dapat ditulis.

[in] ConfigurationHandle

Handel ke kunci registri yang dikembalikan oleh NdisOpenConfigurationEx, NdisOpenConfigurationKeyByIndex, atau Fungsi NdisOpenConfigurationKeyByName .

[in] Keyword

Penunjuk ke jenis NDIS_STRING yang menjelaskan string terhitung yang disediakan penelepon, dalam kumpulan karakter default sistem, menentukan nama entri untuk menulis nilai. Untuk driver Microsoft Windows 2000 dan yang lebih baru, string ini berisi karakter Unicode. Artinya, untuk Windows 2000 dan yang lebih baru, NDIS mendefinisikan jenis NDIS_STRING sebagai jenis UNICODE_STRING .

[in] ParameterValue

Penunjuk ke penelepon yang disediakan NDIS_CONFIGURATION_PARAMETER struktur.

Nilai kembali

Tidak ada

Keterangan

Jika entri dengan nama yang sama seperti pada Kata Kunci sudah ada di bawah kunci registri yang dibuka, NdisWriteConfiguration menggantikan nilainya saat ini dengan nilai yang disediakan pemanggil. Jika tidak, NdisWriteConfiguration menambahkan entri nilai baru dengan nama yang diberikan dan nilai yang diberikan ke registri.

Dalam registri konfigurasi Windows 2000 dan versi yang lebih baru, Kata Kunci NDIS adalah sinonim untuk nama entri nilai. Nama seperti itu adalah urutan karakter Unicode yang dihitung, dihentikan dengan NUL.

Buffer NdisWriteConfiguration dan menyalin string yang disediakan penelepon di Kata Kunci dan data yang disediakan pemanggil yang ditentukan di ParameterValue . Memori ini dibebaskan ketika driver merilis ConfigurationHandle dengan fungsi NdisCloseConfiguration . Pemanggil NdisWriteConfiguration bertanggung jawab untuk merilis string yang di-buffer di Kata Kunci dan memori yang dialokasikan untuk NDIS_CONFIGURATION_PARAMETER struktur.

Sebagai alternatif untuk memanggil NdisWriteConfiguration, setiap driver NDIS dapat mengatur informasi konfigurasi di registri untuk dirinya sendiri menggunakan direktif AddReg dalam file INF driver.

Untuk informasi selengkapnya tentang penyiapan dan penginstalan file untuk Windows 2000 dan versi yang lebih baru, lihat Gambaran Umum Penginstalan Perangkat.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung untuk driver NDIS 6.0 dan NDIS 5.1 (lihat NdisWriteConfiguration (NDIS 5.1)) di Windows Vista. Didukung untuk driver NDIS 5.1 (lihat NdisWriteConfiguration (NDIS 5.1)) di Windows XP.
Target Platform	Universal
Header	ndis.h (termasuk Ndis.h)
Pustaka	Ndis.lib
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	Irql_Miscellaneous_Function(ndis)