Fungsi NetAdapterOpenConfiguration (netadapter.h)
Fungsi NetAdapterOpenConfiguration membuka database konfigurasi adaptor bersih.
Sintaks
NTSTATUS NetAdapterOpenConfiguration(
[_In_] NETADAPTER Adapter,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
[_Out_] NETCONFIGURATION *Configuration
);
Parameter
[_In_] Adapter
Objek adaptor jaringan yang dibuat klien dalam panggilan sebelumnya ke NetAdapterCreate.
[_In_opt_] ConfigurationAttributes
Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang berisi atribut yang disediakan driver untuk objek konfigurasi baru. Parameter ini bersifat opsional dan dapat WDF_NO_OBJECT_ATTRIBUTES.
[_Out_] Configuration
Penunjuk ke lokasi yang menerima handel ke objek konfigurasi adaptor baru.
Menampilkan nilai
Fungsi mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, fungsi ini dapat mengembalikan kode kesalahan NTSTATUS yang sesuai.
Keterangan
Biasanya, klien memanggil fungsi ini dari fungsi panggilan balik EVT_WDF_DRIVER_DEVICE_ADD .
Jika klien menyediakan WDF_OBJECT_ATTRIBUTES, klien menentukan NULL untuk ParentObject. Objek konfigurasi adaptor secara otomatis diinduk ke objek adaptor.
Akibatnya, WDF secara otomatis menghapus objek konfigurasi saat adaptor dihapus. Namun, klien dapat menghapus objek konfigurasi secara manual dengan memanggil WdfObjectDelete, biasanya dari fungsi panggilan balik EVT_WDF_OBJECT_CONTEXT_CLEANUP .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1.21 |
| Versi UMDF minimum | 2.33 |
| Header | netadapter.h (termasuk netadaptercx.h) |
| Pustaka | NetAdapterCxStub.lib |
| IRQL | PASSIVE_LEVEL |