Fungsi NdisOpenConfigurationEx (ndis.h)

Artikel
08/07/2023

Driver NDIS memanggil fungsi NdisOpenConfigurationEx untuk mendapatkan handel konfigurasi yang memungkinkan akses ke parameter konfigurasi di registri.

Sintaks

NDIS_STATUS NdisOpenConfigurationEx(
  [in]  PNDIS_CONFIGURATION_OBJECT ConfigObject,
  [out] PNDIS_HANDLE               ConfigurationHandle
);

Parameter

[in] ConfigObject

Penunjuk ke penelepon yang disediakan dan diinisialisasi NDIS_CONFIGURATION_OBJECT struktur.

[out] ConfigurationHandle

Penunjuk ke variabel yang disediakan penelepon di mana NdisOpenConfigurationEx mengembalikan handel ke kunci registri. Kunci registri mengidentifikasi parameter konfigurasi.

Nilai kembali

NdisOpenConfigurationEx mengembalikan salah satu nilai status berikut:

Menampilkan kode	Deskripsi
NDIS_STATUS_SUCCESS	NdisOpenConfigurationEx berhasil membuka kunci registri tempat parameter konfigurasi driver disimpan.
NDIS_STATUS_RESOURCES	NdisOpenConfigurationEx gagal karena sumber daya yang tidak mencukupi.
NDIS_STATUS_FAILURE	NdisOpenConfigurationEx mengembalikan NDIS_STATUS_FAILURE jika tidak ada nilai sebelumnya yang berlaku.

Keterangan

NdisOpenConfigurationEx mengembalikan handel konfigurasi di parameter ConfigurationHandle . Handel konfigurasi dikaitkan dengan kunci registri yang mengidentifikasi lokasi parameter konfigurasi. Pemanggil dapat meneruskan handel konfigurasi ke fungsi konfigurasi NDIS lainnya untuk membaca atau menulis informasi di registri.

Untuk mengakses informasi konfigurasi, gunakan handel konfigurasi dengan fungsi berikut:

NdisReadConfiguration

NdisWriteConfiguration

NdisOpenConfigurationKeyByName NdisOpenConfigurationKeyByIndex

Jenis data registri yang terkait dengan handel konfigurasi tergantung pada jenis handel yang diteruskan pemanggil ke NdisOpenConfigurationEx di anggota NdisHandle dari NDIS_CONFIGURATION_OBJECT struktur yang dirujuk oleh parameter ConfigObject . Handel dapat mengidentifikasi parameter yang terkait dengan driver atau dengan instans driver.

Jika driver memperoleh handel di NdisHandle dengan Fungsi NdisMRegisterMiniportDriver , NdisOpenConfigurationEx menyediakan handel ke lokasi registri tempat parameter konfigurasi driver miniport disimpan. Driver miniport dapat menggunakan handel konfigurasi hingga memanggil Fungsi NdisMDeregisterMiniportDriver .

Jika driver memperoleh handel di NdisHandle dari parameter MiniportAdapterHandle dari fungsi MiniportInitializeEx , NdisOpenConfigurationEx menyediakan handel ke lokasi registri tempat parameter konfigurasi adaptor miniport disimpan. Driver miniport dapat meneruskan handel konfigurasi ke fungsi NdisReadNetworkAddress untuk mengambil informasi alamat jaringan yang dapat dikonfigurasi oleh perangkat lunak dan dikelola secara lokal. Driver miniport dapat menggunakan handel konfigurasi hingga NDIS menghentikan adaptor miniport dan fungsi MiniportHaltEx kembali.

Jika driver memperoleh handel di NdisHandle dengan Fungsi NdisRegisterProtocolDriver , NdisOpenConfigurationEx menyediakan handel ke lokasi registri tempat parameter konfigurasi driver protokol disimpan. Driver protokol dapat menggunakan handel konfigurasi hingga memanggil Fungsi NdisDeregisterProtocolDriver .

Jika handel di NdisHandle adalah penunjuk ke struktur NDIS_BIND_PARAMETERS yang diteruskan NDIS di parameter BindParameters dari fungsi ProtocolBindAdapterEx , NdisOpenConfigurationEx menyediakan handel ke lokasi registri tempat parameter konfigurasi untuk pengikatan protokol disimpan. Driver protokol dapat menggunakan handel konfigurasi hingga operasi pengikatan selesai.

Jika driver memperoleh handel di NdisHandle dengan memanggil fungsi NdisOpenAdapterEx , NdisOpenConfigurationEx menyediakan handel ke lokasi registri tempat parameter konfigurasi untuk pengikatan protokol disimpan. Driver protokol dapat menggunakan handel konfigurasi hingga memanggil fungsi NdisCloseAdapterEx .

Jika driver filter memperoleh handel di NdisHandle dengan memanggil Fungsi NdisFRegisterFilterDriver , NdisOpenConfigurationEx menyediakan handel ke lokasi registri tempat parameter konfigurasi driver filter disimpan. Driver filter dapat menggunakan handel konfigurasi hingga mereka memanggil Fungsi NdisFDeregisterFilterDriver .

Jika driver filter memperoleh handel di NdisHandle dari parameter NdisFilterHandle dari fungsi FilterAttach , NdisOpenConfigurationEx menyediakan handel ke lokasi registri tempat parameter konfigurasi modul filter disimpan. Driver filter dapat menggunakan handel konfigurasi hingga NDIS mencopot modul filter dan fungsi FilterDetach kembali. Jika driver filter pemantauan menentukan bendera NDIS_CONFIG_FLAG_FILTER_INSTANCE_CONFIGURATION di anggota Bendera NDIS_CONFIGURATION_OBJECT struktur, driver dapat mengakses konfigurasi modul filter untuk modul filter tertentu ketika ada beberapa modul filter yang dikonfigurasi melalui adaptor miniport yang sama. Mengubah driver filter tidak boleh menggunakan bendera ini.

Setelah driver selesai mengakses informasi konfigurasi, driver harus memanggil fungsi NdisCloseConfiguration untuk merilis handel konfigurasi dan sumber daya terkait.

Catatan Untuk memastikan bahwa fungsi ini berjalan di IRQL = PASSIVE_LEVEL, driver dapat menjadwalkan item kerja NDIS dan memanggil ini dan fungsi konfigurasi lainnya dalam konteks panggilan balik item kerja.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDIS 6.0 dan yang lebih baru.
Target Platform	Universal
Header	ndis.h (termasuk Ndis.h)
Pustaka	Ndis.lib
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	Irql_Miscellaneous_Function(ndis), NdisOpenConfigurationEx(ndis)